summaryrefslogtreecommitdiffstats
path: root/doc/basic/date_format.rst
blob: f9460feb9bf67293520fb8f85a06e8219f72a4e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
.. _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.