Merge pull request #211 from kennytm/master
Fix a markdown rendering difference warning.
This commit is contained in:
Brandon W Maister
GitHub
commit
aa0fbc1879
|
|
@ -8,77 +8,77 @@
|
|||
|
||||
The following specifiers are available both to formatting and parsing.
|
||||
|
||||
Spec. | Example | Description
|
||||
----- | ------------- | -----------
|
||||
| | **DATE SPECIFIERS:**
|
||||
`%Y` | `2001` | The full proleptic Gregorian year, zero-padded to 4 digits. [1]
|
||||
`%C` | `20` | The proleptic Gregorian year divided by 100, zero-padded to 2 digits. [2]
|
||||
`%y` | `01` | The proleptic Gregorian year modulo 100, zero-padded to 2 digits. [2]
|
||||
| |
|
||||
`%m` | `07` | Month number (01--12), zero-padded to 2 digits.
|
||||
`%b` | `Jul` | Abbreviated month name. Always 3 letters.
|
||||
`%B` | `July` | Full month name. Also accepts corresponding abbreviation in parsing.
|
||||
`%h` | `Jul` | Same to `%b`.
|
||||
| |
|
||||
`%d` | `08` | Day number (01--31), zero-padded to 2 digits.
|
||||
`%e` | ` 8` | Same to `%d` but space-padded. Same to `%_d`.
|
||||
| |
|
||||
`%a` | `Sun` | Abbreviated weekday name. Always 3 letters.
|
||||
`%A` | `Sunday` | Full weekday name. Also accepts corresponding abbreviation in parsing.
|
||||
`%w` | `0` | Sunday = 0, Monday = 1, ..., Saturday = 6.
|
||||
`%u` | `7` | Monday = 1, Tuesday = 2, ..., Sunday = 7. (ISO 8601)
|
||||
| |
|
||||
`%U` | `28` | Week number starting with Sunday (00--53), zero-padded to 2 digits. [3]
|
||||
`%W` | `27` | Same to `%U`, but week 1 starts with the first Monday in that year instead.
|
||||
| |
|
||||
`%G` | `2001` | Same to `%Y` but uses the year number in ISO 8601 week date. [4]
|
||||
`%g` | `01` | Same to `%y` but uses the year number in ISO 8601 week date. [4]
|
||||
`%V` | `27` | Same to `%U` but uses the week number in ISO 8601 week date (01--53). [4]
|
||||
| |
|
||||
`%j` | `189` | Day of the year (001--366), zero-padded to 3 digits.
|
||||
| |
|
||||
`%D` | `07/08/01` | Month-day-year format. Same to `%m/%d/%y`.
|
||||
`%x` | `07/08/01` | Same to `%D`.
|
||||
`%F` | `2001-07-08` | Year-month-day format (ISO 8601). Same to `%Y-%m-%d`.
|
||||
`%v` | ` 8-Jul-2001` | Day-month-year format. Same to `%e-%b-%Y`.
|
||||
| |
|
||||
| | **TIME SPECIFIERS:**
|
||||
`%H` | `00` | Hour number (00--23), zero-padded to 2 digits.
|
||||
`%k` | ` 0` | Same to `%H` but space-padded. Same to `%_H`.
|
||||
`%I` | `12` | Hour number in 12-hour clocks (01--12), zero-padded to 2 digits.
|
||||
`%l` | `12` | Same to `%I` but space-padded. Same to `%_I`.
|
||||
| |
|
||||
`%P` | `am` | `am` or `pm` in 12-hour clocks.
|
||||
`%p` | `AM` | `AM` or `PM` in 12-hour clocks.
|
||||
| |
|
||||
`%M` | `34` | Minute number (00--59), zero-padded to 2 digits.
|
||||
`%S` | `60` | Second number (00--60), zero-padded to 2 digits. [5]
|
||||
`%f` | `026490000` | The fractional seconds (in nanoseconds) since last whole second. [8]
|
||||
`%.f` | `.026490` | Similar to `.%f` but left-aligned. These all consume the leading dot. [8]
|
||||
`%.3f`| `.026` | Similar to `.%f` but left-aligned but fixed to a length of 3. [8]
|
||||
`%.6f`| `.026490` | Similar to `.%f` but left-aligned but fixed to a length of 6. [8]
|
||||
`%.9f`| `.026490000` | Similar to `.%f` but left-aligned but fixed to a length of 9. [8]
|
||||
| |
|
||||
`%R` | `00:34` | Hour-minute format. Same to `%H:%M`.
|
||||
`%T` | `00:34:60` | Hour-minute-second format. Same to `%H:%M:%S`.
|
||||
`%X` | `00:34:60` | Same to `%T`.
|
||||
`%r` | `12:34:60 AM` | Hour-minute-second format in 12-hour clocks. Same to `%I:%M:%S %p`.
|
||||
| |
|
||||
| | **TIME ZONE SPECIFIERS:**
|
||||
`%Z` | `ACST` | *Formatting only:* Local time zone name.
|
||||
`%z` | `+0930` | Offset from the local time to UTC (with UTC being `+0000`).
|
||||
`%:z` | `+09:30` | Same to `%z` but with a colon.
|
||||
| |
|
||||
| | **DATE & TIME SPECIFIERS:**
|
||||
`%c` | `Sun Jul 8 00:34:60 2001` | `ctime` date & time format. Same to `%a %b %e %T %Y` sans `\n`.
|
||||
`%+` | `2001-07-08T00:34:60.026490+09:30` | ISO 8601 / RFC 3339 date & time format. [6]
|
||||
| |
|
||||
`%s` | `994518299` | UNIX timestamp, the number of seconds since 1970-01-01 00:00 UTC. [7]
|
||||
| |
|
||||
| | **SPECIAL SPECIFIERS:**
|
||||
`%t` | | Literal tab (`\t`).
|
||||
`%n` | | Literal newline (`\n`).
|
||||
`%%` | | Literal percent sign.
|
||||
| Spec. | Example | Description |
|
||||
|-------|----------|----------------------------------------------------------------------------|
|
||||
| | | **DATE SPECIFIERS:** |
|
||||
| `%Y` | `2001` | The full proleptic Gregorian year, zero-padded to 4 digits. [1] |
|
||||
| `%C` | `20` | The proleptic Gregorian year divided by 100, zero-padded to 2 digits. [2] |
|
||||
| `%y` | `01` | The proleptic Gregorian year modulo 100, zero-padded to 2 digits. [2] |
|
||||
| | | |
|
||||
| `%m` | `07` | Month number (01--12), zero-padded to 2 digits. |
|
||||
| `%b` | `Jul` | Abbreviated month name. Always 3 letters. |
|
||||
| `%B` | `July` | Full month name. Also accepts corresponding abbreviation in parsing. |
|
||||
| `%h` | `Jul` | Same to `%b`. |
|
||||
| | | |
|
||||
| `%d` | `08` | Day number (01--31), zero-padded to 2 digits. |
|
||||
| `%e` | ` 8` | Same to `%d` but space-padded. Same to `%_d`. |
|
||||
| | | |
|
||||
| `%a` | `Sun` | Abbreviated weekday name. Always 3 letters. |
|
||||
| `%A` | `Sunday` | Full weekday name. Also accepts corresponding abbreviation in parsing. |
|
||||
| `%w` | `0` | Sunday = 0, Monday = 1, ..., Saturday = 6. |
|
||||
| `%u` | `7` | Monday = 1, Tuesday = 2, ..., Sunday = 7. (ISO 8601) |
|
||||
| | | |
|
||||
| `%U` | `28` | Week number starting with Sunday (00--53), zero-padded to 2 digits. [3] |
|
||||
| `%W` | `27` | Same to `%U`, but week 1 starts with the first Monday in that year instead.|
|
||||
| | | |
|
||||
| `%G` | `2001` | Same to `%Y` but uses the year number in ISO 8601 week date. [4] |
|
||||
| `%g` | `01` | Same to `%y` but uses the year number in ISO 8601 week date. [4] |
|
||||
| `%V` | `27` | Same to `%U` but uses the week number in ISO 8601 week date (01--53). [4] |
|
||||
| | | |
|
||||
| `%j` | `189` | Day of the year (001--366), zero-padded to 3 digits. |
|
||||
| | | |
|
||||
| `%D` | `07/08/01` | Month-day-year format. Same to `%m/%d/%y`. |
|
||||
| `%x` | `07/08/01` | Same to `%D`. |
|
||||
| `%F` | `2001-07-08` | Year-month-day format (ISO 8601). Same to `%Y-%m-%d`. |
|
||||
| `%v` | ` 8-Jul-2001` | Day-month-year format. Same to `%e-%b-%Y`. |
|
||||
| | | |
|
||||
| | | **TIME SPECIFIERS:** |
|
||||
| `%H` | `00` | Hour number (00--23), zero-padded to 2 digits. |
|
||||
| `%k` | ` 0` | Same to `%H` but space-padded. Same to `%_H`. |
|
||||
| `%I` | `12` | Hour number in 12-hour clocks (01--12), zero-padded to 2 digits. |
|
||||
| `%l` | `12` | Same to `%I` but space-padded. Same to `%_I`. |
|
||||
| | | |
|
||||
| `%P` | `am` | `am` or `pm` in 12-hour clocks. |
|
||||
| `%p` | `AM` | `AM` or `PM` in 12-hour clocks. |
|
||||
| | | |
|
||||
| `%M` | `34` | Minute number (00--59), zero-padded to 2 digits. |
|
||||
| `%S` | `60` | Second number (00--60), zero-padded to 2 digits. [5] |
|
||||
| `%f` | `026490000` | The fractional seconds (in nanoseconds) since last whole second. [8] |
|
||||
| `%.f` | `.026490`| Similar to `.%f` but left-aligned. These all consume the leading dot. [8] |
|
||||
| `%.3f`| `.026` | Similar to `.%f` but left-aligned but fixed to a length of 3. [8] |
|
||||
| `%.6f`| `.026490` | Similar to `.%f` but left-aligned but fixed to a length of 6. [8] |
|
||||
| `%.9f`| `.026490000` | Similar to `.%f` but left-aligned but fixed to a length of 9. [8] |
|
||||
| | | |
|
||||
| `%R` | `00:34` | Hour-minute format. Same to `%H:%M`. |
|
||||
| `%T` | `00:34:60` | Hour-minute-second format. Same to `%H:%M:%S`. |
|
||||
| `%X` | `00:34:60` | Same to `%T`. |
|
||||
| `%r` | `12:34:60 AM` | Hour-minute-second format in 12-hour clocks. Same to `%I:%M:%S %p`. |
|
||||
| | | |
|
||||
| | | **TIME ZONE SPECIFIERS:** |
|
||||
| `%Z` | `ACST` | *Formatting only:* Local time zone name. |
|
||||
| `%z` | `+0930` | Offset from the local time to UTC (with UTC being `+0000`). |
|
||||
| `%:z` | `+09:30` | Same to `%z` but with a colon. |
|
||||
| | | |
|
||||
| | | **DATE & TIME SPECIFIERS:** |
|
||||
|`%c`|`Sun Jul 8 00:34:60 2001`|`ctime` date & time format. Same to `%a %b %e %T %Y` sans `\n`.|
|
||||
| `%+` | `2001-07-08T00:34:60.026490+09:30` | ISO 8601 / RFC 3339 date & time format. [6] |
|
||||
| | | |
|
||||
| `%s` | `994518299` | UNIX timestamp, the number of seconds since 1970-01-01 00:00 UTC. [7] |
|
||||
| | | |
|
||||
| | | **SPECIAL SPECIFIERS:** |
|
||||
| `%t` | | Literal tab (`\t`). |
|
||||
| `%n` | | Literal newline (`\n`). |
|
||||
| `%%` | | Literal percent sign. |
|
||||
|
||||
It is possible to override the default padding behavior of numeric specifiers `%?`.
|
||||
This is not allowed for other specifiers and will result in the `BAD_FORMAT` error.
|
||||
|
|
|
|||
Loading…
Reference in New Issue