time
time(1) BIG-IP TMSH Manual time(1)
NAME
Time - Date and Time formats.
MODULE
All tmsh modules.
SYNTAX
Date/Time Syntax
now[ [ + | - ] [ d | h | w | m ] ]
yyyy-mm-dd[ : | T ]hh:mm[:ss]
mm-dd[-yyyy][ : | T ]hh:mm[:ss]
mm/dd[/yyyy][ : | T ]hh:mm[:ss]
Date Range Syntax
now[ [ + | - ] [ d | h | w | m ] ]--now[ [ + | - ] [ d | h | w | m ] ]
yyyy-mm-dd[ : | T ]hh:mm[:ss]--yyyy-mm-dd[ : | T ]hh:mm[:ss]
mm-dd[-yyyy][ : | T ]hh:mm[:ss]--indefinite
epoch--mm/dd[/yyyy][ : | T ]hh:mm[:ss]
now[ [ + | - ] [ d | h | w | m ] ]
DESCRIPTION
The date or time format is found in tmsh as an attribute or parameter for many configuration items. Below are
the various formats supported for both Date/Time and Date Range. Please see the examples for further
assistance in using the required formats.
DATE:TIME FORMATS
nowX This date format starts with now (the current time) and is optionally followed by + or - some time span.
The format will look like the following: now[ [ + | - ] integer [ d | h | w | m ] ], where the user picks
either before (-) or after (+) the current time and then specifies integer number of minutes(m),
hours(h), days(d) or weeks(w). This format is case-insensitive.
Examples:
Input Date Description
now-3d 3 days ago.
now+3h 3 hours from now.
now-3m 3 minutes ago.
now+3w 3 weeks from now.
yyyy-mm-dd:hh:mm:ss
This format requires a year, month, day separated by - characters. A time is also required, which is
specified as hour:minute:second, where the seconds are optional. The date and time must be separated by a
: colon. Note: This is the default time format for output from tmsh.
Examples:
Input Date Description
2013-05-29:13:30 May 29th, 2013 at 1:30pm.
2000-01-04:12:22:30 January 4th, 2000 at 12:22pm and 30 seconds.
mm-dd-yyyy:hh:mm:ss
This format requires at least a month(m) and day(d) specified and optionally a year (y). If no year is
specified, tmsh will auto-fill the year with the current year. A time is also required in the format of
hour:minute:second, where the seconds are optional.
Examples:
Input Date Description
3-12-2015:12:01:00 March 12th, 2015 at 12:01 pm.
4-15:22:10:30 April 15th of this year at 10:10 pm and 30 seconds.
mm/dd/yyyy:hh:mm:ss
This format requires at least a month(m) and day(d) specified and optionally a year (y). If no year is
specified, tmsh will auto-fill the year with the current year. A time is also required in the format of
hour:minute:second, where the seconds are optional.
Examples:
Input Date Description
3/12/2015:12:01:00 March 12th, 2015 at 12:01 pm.
4/15:22:10:30 April 15th of this year at 10:10 pm and 30 seconds.
T Delimiter
Any of the above time formats may optionally use a capital letter T (as in the word Time) to separate the
date from the time, instead of using a colon (:).
Examples:
Input Date Description
9/16/2005T12:01:01 September 16th, 2005 at 12:01pm and 1 second.
2011-11-12T00:03:30 November 12th, 2011 at 12:03am and 30 seconds.
Special Dates
There are two special dates that may be used in tmsh. They are indefinite and epoch. Below is an
explanation of those dates.
indefinite
The date will be marked as being infinitely in the future (end of time).
epoch
The date will be marked as being infinitely in the past (beginning of time).
DATE RANGES
DateX--DateZ
A Date Range is 2 dates in a valid Date Format separated by a -- (double hyphen). The dates may be any of
the Date Formats specified above. See examples below on how to use this notation.
Examples:
Input Date Description
now-2d--now-4d 2 to 4 days ago.
now--now-3m From 3 minutes ago to now.
epoch--3/12/2011:12:00:00 Everything older than March 12th, 2011 at noon.
2008-03-12--indefinite Everything after midnight on March 12th, 2008.
DateX
When specifying a date range, the second date may be left out. This will cause the system to assume the
second date in the range to be now. Using this format for a date range may make it confusing when using
the NowX date format listed above. The following examples will help clarify how to use this format with
any supported Date Format.
Examples:
Input Date Description
now-3d From 3 days ago to now.
now+3w From now to 3 weeks from now.
epoch Everything before the current date and time.
indefinite Everything after the current date and time.
SEE ALSO
tmsh, create, modify
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose
other than the purchaser's personal use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008-2013, 2016. All rights reserved.
BIG-IP 2016-03-14 time(1)