.. _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.