120 lines
3.9 KiB
Plaintext
120 lines
3.9 KiB
Plaintext
|
|
p.location-badge.
|
|
exported from <a href='../pipes'>angular2/pipes</a>
|
|
defined in <a href="https://github.com/angular/angular/tree/2.0.0-alpha.32/modules/angular2/src/change_detection/pipes/date_pipe.ts#L16-L100">angular2/src/change_detection/pipes/date_pipe.ts (line 16)</a>
|
|
|
|
:markdown
|
|
Formats a date value to a string based on the requested format.
|
|
|
|
# Usage
|
|
|
|
expression | date[:format]
|
|
|
|
where `expression` is a date object or a number (milliseconds since UTC epoch) and
|
|
`format` indicates which date/time components to include:
|
|
|
|
| Component | Symbol | Short Form | Long Form | Numeric | 2-digit |
|
|
|-----------|:------:|--------------|-------------------|-----------|-----------|
|
|
| era | G | G (AD) | GGGG (Anno Domini)| - | - |
|
|
| year | y | - | - | y (2015) | yy (15) |
|
|
| month | M | MMM (Sep) | MMMM (September) | M (9) | MM (09) |
|
|
| day | d | - | - | d (3) | dd (03) |
|
|
| weekday | E | EEE (Sun) | EEEE (Sunday) | - | - |
|
|
| hour | j | - | - | j (13) | jj (13) |
|
|
| hour12 | h | - | - | h (1 PM) | hh (01 PM)|
|
|
| hour24 | H | - | - | H (13) | HH (13) |
|
|
| minute | m | - | - | m (5) | mm (05) |
|
|
| second | s | - | - | s (9) | ss (09) |
|
|
| timezone | z | - | z (Pacific Standard Time)| - | - |
|
|
| timezone | Z | Z (GMT-8:00) | - | - | - |
|
|
|
|
In javascript, only the components specified will be respected (not the ordering,
|
|
punctuations, ...) and details of the the formatting will be dependent on the locale.
|
|
On the other hand in Dart version, you can also include quoted text as well as some extra
|
|
date/time components such as quarter. For more information see:
|
|
https://api.dartlang.org/apidocs/channels/stable/dartdoc-viewer/intl/intl.DateFormat.
|
|
|
|
`format` can also be one of the following predefined formats:
|
|
|
|
- `'medium'`: equivalent to `'yMMMdjms'` (e.g. Sep 3, 2010, 12:05:08 PM for en-US)
|
|
- `'short'`: equivalent to `'yMdjm'` (e.g. 9/3/2010, 12:05 PM for en-US)
|
|
- `'fullDate'`: equivalent to `'yMMMMEEEEd'` (e.g. Friday, September 3, 2010 for en-US)
|
|
- `'longDate'`: equivalent to `'yMMMMd'` (e.g. September 3, 2010)
|
|
- `'mediumDate'`: equivalent to `'yMMMd'` (e.g. Sep 3, 2010 for en-US)
|
|
- `'shortDate'`: equivalent to `'yMd'` (e.g. 9/3/2010 for en-US)
|
|
- `'mediumTime'`: equivalent to `'jms'` (e.g. 12:05:08 PM for en-US)
|
|
- `'shortTime'`: equivalent to `'jm'` (e.g. 12:05 PM for en-US)
|
|
|
|
Timezone of the formatted text will be the local system timezone of the end-users machine.
|
|
|
|
# Examples
|
|
|
|
Assuming `dateObj` is (year: 2015, month: 6, day: 15, hour: 21, minute: 43, second: 11)
|
|
in the _local_ time and locale is 'en-US':
|
|
|
|
{{ dateObj | date }} // output is 'Jun 15, 2015'
|
|
{{ dateObj | date:'medium' }} // output is 'Jun 15, 2015, 9:43:11 PM'
|
|
{{ dateObj | date:'shortTime' }} // output is '9:43 PM'
|
|
{{ dateObj | date:'mmss' }} // output is '43:11'
|
|
|
|
|
|
|
|
.l-main-section
|
|
h2 Annotations
|
|
.l-sub-section
|
|
h3.annotation CONST
|
|
pre.prettyprint
|
|
code.
|
|
@CONST()
|
|
|
|
|
|
.l-main-section
|
|
h2 Members
|
|
.l-sub-section
|
|
h3 transform
|
|
|
|
|
|
pre.prettyprint
|
|
code.
|
|
transform(value: any, args: List<any>)
|
|
|
|
:markdown
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.l-sub-section
|
|
h3 supports
|
|
|
|
|
|
pre.prettyprint
|
|
code.
|
|
supports(obj: any)
|
|
|
|
:markdown
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.l-sub-section
|
|
h3 create
|
|
|
|
|
|
pre.prettyprint
|
|
code.
|
|
create(cdRef: ChangeDetectorRef)
|
|
|
|
:markdown
|
|
|
|
|
|
|
|
|
|
|
|
|