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)