-
Notifications
You must be signed in to change notification settings - Fork 364
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
New "Supported date and time formats" document
- Loading branch information
Showing
2 changed files
with
139 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,138 @@ | ||
.. _datetime: | ||
|
||
Supported date and time formats. | ||
================================ | ||
|
||
.. _duration: | ||
|
||
Duration ("deltat") | ||
------------------- | ||
|
||
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: | ||
addprincl test1 -expire "3/27/12 10:00:07 EST" | ||
addprincl test2 -expire "January 23, 2015 10:05pm" | ||
addprincl test3 -expire "22:00 GMT" | ||
Add a principal that will expire in 30 minutes: | ||
addprincl 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:30:00 | 8 o'clock in | | ||
+------------------------+----------------------+ the evening | | ||
| hhmmss | 203000 | | | ||
+------------------------+----------------------+--------------+ | ||
|
||
(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 (00-12); | ||
| *N* : number; | ||
| *pp* : AM or PM; | ||
| *ss* : seconds (00-60); | ||
| *tt* : time units (houris, 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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -9,3 +9,4 @@ Basic Kerberos V5 concepts | |
|
||
keytab_def.rst | ||
stash_file_def.rst | ||
date_time.rst |