Response Templating - Dates and Times
MockLab has two helpers for manipulating dates - now
and date
.
Current date/time
The now
helper renders the current date/time, with the ability to specify the format (see full reference) and offset.
Dates can be rendered in a specific timezone (the default is UTC):
Pass epoch
as the format to render the date as UNIX epoch time (in milliseconds), or unix
as the format to render
the UNIX timestamp in seconds.
Existing date values
The date
helper can be used to manipulate existing date values, changing the
offset, timezone and print format in exactly the same manner as with the now
helper.
Parsing dates from strings
Dates can be parsed from other model elements. This is mostly useful when passed to
the date
helper for further processing:
Formatting dates
Date values can be formatted to strings using the dateFormat
helper. You can
either select a named format from the following:
full
: full date format. For example: Tuesday, June 19, 2012long
: long date format. For example: June 19, 2012medium
: medium date format. For example: Jun 19, 2012short
: short date format. For example: 6/19/12
e.g.
Or you can specify your own format string (full reference here):
Format string reference
The following details all of the format string elements used when formatting and parsing dates and times:
Letter | Date or Time Component | Presentation | Examples |
---|---|---|---|
G
| Era designator | Text | AD
|
y
| Year | Year | 1996 ; 96
|
Y
| Week year | Year | 2009 ; 09
|
M
| Month in year | Month | July ; Jul ; 07
|
w
| Week in year | Number | 27
|
W
| Week in month | Number | 2
|
D
| Day in year | Number | 189
|
d
| Day in month | Number | 10
|
F
| Day of week in month | Number | 2
|
E
| Day name in week | Text | Tuesday ; Tue
|
u
| Day number of week (1 = Monday, ..., 7 = Sunday) | Number | 1
|
a
| Am/pm marker | Text | PM
|
H
| Hour in day (0-23) | Number | 0
|
k
| Hour in day (1-24) | Number | 24
|
K
| Hour in am/pm (0-11) | Number | 0
|
h
| Hour in am/pm (1-12) | Number | 12
|
m
| Minute in hour | Number | 30
|
s
| Second in minute | Number | 55
|
S
| Millisecond | Number | 978
|
z
| Time zone | General time zone | Pacific Standard Time ; PST ; GMT-08:00
|
Z
| Time zone | RFC 822 time zone | -0800
|
X
| Time zone | ISO 8601 time zone | -08 ; -0800 ; -08:00
|