diff options
author | Travis Oliphant <oliphant@enthought.com> | 2009-08-26 23:01:41 +0000 |
---|---|---|
committer | Travis Oliphant <oliphant@enthought.com> | 2009-08-26 23:01:41 +0000 |
commit | e1b97821a34b02493d3487ffc3a2696ef449bd4d (patch) | |
tree | 55bcb8a0187206dca2f3af868b412dfd30889e0f /doc/neps/datetime-proposal.rst | |
parent | ed997cb5f3816ef60e741d3bc877d1fdcc596d07 (diff) | |
download | numpy-e1b97821a34b02493d3487ffc3a2696ef449bd4d.tar.gz |
Check-in work for Wednesday.
Diffstat (limited to 'doc/neps/datetime-proposal.rst')
-rw-r--r-- | doc/neps/datetime-proposal.rst | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/doc/neps/datetime-proposal.rst b/doc/neps/datetime-proposal.rst index 7f4cd4cea..39e3f7a98 100644 --- a/doc/neps/datetime-proposal.rst +++ b/doc/neps/datetime-proposal.rst @@ -86,8 +86,29 @@ A time unit is specified by a string consisting of a base-type given in the above table Besides these basic code units, the user can create derived units -consisting of rational multiples of any basic unit: 100ns, Y/4, 3M, -32s/42, etc. +consisting of multiples of any basic unit: 100ns, 3M, 15m, etc. + +A limited number of divisions of any basic unit can be used to create multiples +of a higher-resolution unit provided the divisor can be divided evenly into +the number of higher-resolution units available. +For example: Y/4 is just short-hand for -> (12M)/4 -> 3M and Y/4 will be represented + after creation as 3M +The first lower unit found to have an even divisor will be chosen + (up to 3 lower units). The following standardized definitions are used + in this specific case to find acceptable divisors + + +Y - 12M, 52W, 365D +M - 4W, 30D, 720h +W - 5B,7D, 168h, 10080m +B - 24h, 1440m, 86400s +D - 24h, 1440m, 86400s +h - 60m, 3600s +m - 60s, 60000ms + +s, ms, us, ns, ps, fs (use 1000 and 1000000 of the next two + available lower units respectively). + Finally, a date-time data-type can be created with support for tracking sequential events within a basic unit: [D]//100, [Y]//4 (notice the |