.. _datetime:

Supported date and time formats

===============================

.. _duration:

Time duration

-------------

This format is used to express a time duration in the Kerberos

configuration files and user commands.  The allowed formats are:

 ====================== ============== ============

 Format                      Example        Value

 ---------------------- -------------- ------------

  h:m[:s]                36:00          36 hours

  NdNhNmNs               8h30s          8 hours 30 seconds

  N (number of seconds)  3600           1 hour

 ====================== ============== ============

Here *N* denotes a number, *d* - days, *h* - hours, *m* - minutes,

*s* - seconds.

.. note::

    The time interval should not exceed 2147483647 seconds.

Examples::

    Request a ticket valid for one hour, five hours, 30 minutes

    and 10 days respectively:

      kinit -l 3600

      kinit -l 5:00

      kinit -l 30m

      kinit -l "10d 0h 0m 0s"

.. _getdate:

getdate time

------------

Some of the kadmin and kdb5_util commands take a date-time in a

human-readable format.  Some of the acceptable date-time

strings are:

 +-----------+------------------+-----------------+

 |           |   Format         | Example         |

 +===========+==================+=================+

 | Date      |   mm/dd/yy       | 07/27/12        |

 |           +------------------+-----------------+

 |           | month dd, yyyy   | Jul 27, 2012    |

 |           +------------------+-----------------+

 |           |   yyyy-mm-dd     |  2012-07-27     |

 +-----------+------------------+-----------------+

 | Absolute  | HH:mm[:ss]pp     |  08:30 PM       |

 | time      +------------------+-----------------+

 |           | hh:mm[:ss]       |  20:30          |

 +-----------+------------------+-----------------+

 | Relative  | N tt             |  30 sec         |

 | time      |                  |                 |

 +-----------+------------------+-----------------+

 | Time zone | Z                |  EST            |

 |           +------------------+-----------------+

 |           | z                |  -0400          |

 +-----------+------------------+-----------------+

(See :ref:`abbreviation`.)

Examples::

    Create a principal that expires on the date indicated:

        addprinc test1 -expire "3/27/12 10:00:07 EST"

        addprinc test2 -expire "January 23, 2015 10:05pm"

        addprinc test3 -expire "22:00 GMT"

    Add a principal that will expire in 30 minutes:

        addprinc test4 -expire "30 minutes"

.. _abstime:

Absolute time

-------------

This rarely used date-time format can be noted in one of the

following ways:

 +------------------------+----------------------+--------------+

 | Format                 | Example              | Value        |

 +========================+======================+==============+

 | yyyymmddhhmmss         | 20141231235900       | One minute   |

 +------------------------+----------------------+ before 2015  |

 | yyyy.mm.dd.hh.mm.ss    | 2014.12.31.23.59.00  |              |

 +------------------------+----------------------+              |

 | yymmddhhmmss           | 141231235900         |              |

 +------------------------+----------------------+              |

 | yy.mm.dd.hh.mm.ss      | 14.12.31.23.59.00    |              |

 +------------------------+----------------------+              |

 | dd-month-yyyy:hh:mm:ss | 31-Dec-2014:23:59:00 |              |

 +------------------------+----------------------+--------------+

 | hh:mm:ss               | 20:00:00             | 8 o'clock in |

 +------------------------+----------------------+ the evening  |

 | hhmmss                 | 200000               |              |

 +------------------------+----------------------+--------------+

(See :ref:`abbreviation`.)

Example::

    Set the default expiration date to July 27, 2012 at 20:30

    default_principal_expiration = 20120727203000

.. _abbreviation:

Abbreviations used in this document

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

| *month*  : locale’s month name or its abbreviation;

| *dd*   : day of month (01-31);

| *HH*   : hours (00-12);

| *hh*   : hours (00-23);

| *mm*   : in time - minutes (00-59); in date - month (01-12);

| *N*    : number;

| *pp*   : AM or PM;

| *ss*   : seconds  (00-60);

| *tt*   : time units (hours, minutes, min, seconds, sec);

| *yyyy* : year;

| *yy*   : last two digits of the year;

| *Z*    : alphabetic time zone abbreviation;

| *z*    : numeric time zone;

.. note::

     - If the date specification contains spaces, you may need to

       enclose it in double quotes;

     - All keywords are case-insensitive.