Stowage/go
2
0
Fork 0
mirror of https://github.com/golang/go.git synced 2025-12-08 06:10:04 +00:00
Code Issues Projects Releases Packages Wiki Activity

time: explain the formats a little better.

Browse source 
R=gri, rsc
CC=golang-dev
https://golang.org/cl/3719042
This commit is contained in:
Rob Pike 2010-12-16 13:25:41 -08:00
parent 1e3b9524d2
commit 2e8be52ff7
1 changed files with 11 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

18
src/pkg/time/format.go
View file

@ -19,10 +19,12 @@ const (
// Mon Jan 2 15:04:05 MST 2006 (MST is GMT-0700) // Mon Jan 2 15:04:05 MST 2006 (MST is GMT-0700)
// which is Unix time 1136243045. // which is Unix time 1136243045.
// (Think of it as 01/02 03:04:05PM '06 -0700.) // (Think of it as 01/02 03:04:05PM '06 -0700.)
// An underscore _ represents a space that // To define your own format, write down what the standard
// may be replaced by a digit if the following number // time would look like formatted your way.
// (a day) has two digits; for compatibility with //
// fixed-width Unix time formats. // Within the format string, an underscore _ represents a space that may be
// replaced by a digit if the following number (a day) has two digits; for
// compatibility with fixed-width Unix time formats.
// //
// Numeric time zone offsets format as follows: // Numeric time zone offsets format as follows:
// -0700 ±hhmm // -0700 ±hhmm
@ -41,8 +43,8 @@ const (
RFC822Z = "02 Jan 06 1504 -0700" RFC822Z = "02 Jan 06 1504 -0700"
RFC850 = "Monday, 02-Jan-06 15:04:05 MST" RFC850 = "Monday, 02-Jan-06 15:04:05 MST"
RFC1123 = "Mon, 02 Jan 2006 15:04:05 MST" RFC1123 = "Mon, 02 Jan 2006 15:04:05 MST"
Kitchen = "3:04PM"
RFC3339 = "2006-01-02T15:04:05Z07:00" RFC3339 = "2006-01-02T15:04:05Z07:00"
Kitchen = "3:04PM"
) )
const ( const (
@ -232,7 +234,8 @@ func zeroPad(i int) string { return pad(i, "0") }
// according to layout. The layout defines the format by showing the // according to layout. The layout defines the format by showing the
// representation of a standard time, which is then used to describe // representation of a standard time, which is then used to describe
// the time to be formatted. Predefined layouts ANSIC, UnixDate, // the time to be formatted. Predefined layouts ANSIC, UnixDate,
// RFC3339 and others describe standard representations. // RFC3339 and others describe standard representations. For more
// information about the formats, see the documentation for ANSIC.
func (t *Time) Format(layout string) string { func (t *Time) Format(layout string) string {
b := new(bytes.Buffer) b := new(bytes.Buffer)
// Each iteration generates one std value. // Each iteration generates one std value.
@ -414,7 +417,8 @@ func skip(value, prefix string) (string, os.Error) {
// The layout defines the format by showing the representation of a standard // The layout defines the format by showing the representation of a standard
// time, which is then used to describe the string to be parsed. Predefined // time, which is then used to describe the string to be parsed. Predefined
// layouts ANSIC, UnixDate, RFC3339 and others describe standard // layouts ANSIC, UnixDate, RFC3339 and others describe standard
// representations. // representations.For more information about the formats, see the
// documentation for ANSIC.
// //
// Only those elements present in the value will be set in the returned time // Only those elements present in the value will be set in the returned time
// structure. Also, if the input string represents an inconsistent time // structure. Also, if the input string represents an inconsistent time