qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-11 22:50:22 -07:00
Code Releases Activity

time: make it clearer how to format a fractional second

Browse Source 
Fixes #10963.

Change-Id: I8d769b4d25b306f2df41f882ec01d97bbd63171d
Reviewed-on: https://go-review.googlesource.com/12221
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Andrew Gerrand <adg@golang.org>
This commit is contained in:
Rob Pike 2015-07-15 15:02:38 +10:00
parent d000e8742a
commit 47f22ab775
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
src/time/format.go
View File

@ -39,6 +39,9 @@ import "errors"
// offset for the UTC zone. Thus: // offset for the UTC zone. Thus:
// Z0700 Z or ±hhmm // Z0700 Z or ±hhmm
// Z07:00 Z or ±hh:mm // Z07:00 Z or ±hh:mm
//
// The executable example for time.Format demonstrates the working
// of the layout string in detail and is a good reference.
const ( const (
ANSIC = "Mon Jan _2 15:04:05 2006" ANSIC = "Mon Jan _2 15:04:05 2006"
UnixDate = "Mon Jan _2 15:04:05 MST 2006" UnixDate = "Mon Jan _2 15:04:05 MST 2006"
@ -405,6 +408,11 @@ func (t Time) String() string {
// would be displayed if it were the value; it serves as an example of the // would be displayed if it were the value; it serves as an example of the
// desired output. The same display rules will then be applied to the time // desired output. The same display rules will then be applied to the time
// value. // value.
//
// A fractional second is represented by adding a period and zeros
// to the end of the seconds section of layout string, as in "15:04:05.000"
// to format a time stamp with millisecond precision.
//
// Predefined layouts ANSIC, UnixDate, RFC3339 and others describe standard // Predefined layouts ANSIC, UnixDate, RFC3339 and others describe standard
// and convenient representations of the reference time. For more information // and convenient representations of the reference time. For more information
// about the formats and the definition of the reference time, see the // about the formats and the definition of the reference time, see the
@ -671,7 +679,7 @@ func skip(value, prefix string) (string, error) {
// and convenient representations of the reference time. For more information // and convenient representations of the reference time. For more information
// about the formats and the definition of the reference time, see the // about the formats and the definition of the reference time, see the
// documentation for ANSIC and the other constants defined by this package. // documentation for ANSIC and the other constants defined by this package.
// Also, the executable Example for time.Format demonstrates the working // Also, the executable example for time.Format demonstrates the working
// of the layout string in detail and is a good reference. // of the layout string in detail and is a good reference.
// //
// Elements omitted from the value are assumed to be zero or, when // Elements omitted from the value are assumed to be zero or, when