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)