annotate lisp/calendar/parse-time.el @ 82415:19bb0634dbdc

Docstring fix
author Vinicius Jose Latorre <viniciusjl@ig.com.br>
date Thu, 16 Aug 2007 22:27:35 +0000
parents 93e11478c954
children 974a828870fe f55f9811f5d7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
1 ;;; parse-time.el --- parsing time strings
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
2
75346
7a3f13e2dd57 Add 2007 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 68721
diff changeset
3 ;; Copyright (C) 1996, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
67465
a55ee709ec8d Update copyright pending Emacs 22.
Glenn Morris <rgm@gnu.org>
parents: 64085
diff changeset
4 ;; Free Software Foundation, Inc.
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
5
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
6 ;; Author: Erik Naggum <erik@naggum.no>
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
7 ;; Keywords: util
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
8
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
10
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
78216
93e11478c954 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 77287
diff changeset
13 ;; the Free Software Foundation; either version 3, or (at your option)
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
14 ;; any later version.
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
15
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
19 ;; GNU General Public License for more details.
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
20
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
21 ;; You should have received a copy of the GNU General Public License
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
22 ;; along with GNU Emacs; see the file COPYING. If not, write to
64085
18a818a2ee7c Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52623
diff changeset
23 ;; the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18a818a2ee7c Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52623
diff changeset
24 ;; Boston, MA 02110-1301, USA.
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
25
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
26 ;;; Commentary:
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
27
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
28 ;; With the introduction of the `encode-time', `decode-time', and
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
29 ;; `format-time-string' functions, dealing with time became simpler in
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
30 ;; Emacs. However, parsing time strings is still largely a matter of
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
31 ;; heuristics and no common interface has been designed.
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
32
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
33 ;; `parse-time-string' parses a time in a string and returns a list of 9
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
34 ;; values, just like `decode-time', where unspecified elements in the
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
35 ;; string are returned as nil. `encode-time' may be applied on these
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
36 ;; values to obtain an internal time value.
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
37
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
38 ;;; Code:
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
39
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
40 (eval-when-compile (require 'cl)) ;and ah ain't kiddin' 'bout it
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
41
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
42 (defvar parse-time-syntax (make-vector 256 nil))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
43 (defvar parse-time-digits (make-vector 256 nil))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
44
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
45 ;; Byte-compiler warnings
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
46 (defvar parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
47 (defvar parse-time-val)
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
48
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
49 (unless (aref parse-time-digits ?0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
50 (loop for i from ?0 to ?9
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
51 do (aset parse-time-digits i (- i ?0))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
52
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
53 (unless (aref parse-time-syntax ?0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
54 (loop for i from ?0 to ?9
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
55 do (aset parse-time-syntax i ?0))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
56 (loop for i from ?A to ?Z
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
57 do (aset parse-time-syntax i ?A))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
58 (loop for i from ?a to ?z
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
59 do (aset parse-time-syntax i ?a))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
60 (aset parse-time-syntax ?+ 1)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
61 (aset parse-time-syntax ?- -1)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
62 (aset parse-time-syntax ?: ?d)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
63 )
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
64
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
65 (defsubst digit-char-p (char)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
66 (aref parse-time-digits char))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
67
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
68 (defsubst parse-time-string-chars (char)
77287
293993a9e1e7 (parse-time-string-chars): Check if CHAR is less than the length of
Kenichi Handa <handa@m17n.org>
parents: 75346
diff changeset
69 (and (< char (length parse-time-syntax))
293993a9e1e7 (parse-time-string-chars): Check if CHAR is less than the length of
Kenichi Handa <handa@m17n.org>
parents: 75346
diff changeset
70 (aref parse-time-syntax char)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
71
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
72 (put 'parse-error 'error-conditions '(parse-error error))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
73 (put 'parse-error 'error-message "Parsing error")
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
74
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
75 (defsubst parse-integer (string &optional start end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
76 "[CL] Parse and return the integer in STRING, or nil if none."
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
77 (let ((integer 0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
78 (digit 0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
79 (index (or start 0))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
80 (end (or end (length string))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
81 (when (< index end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
82 (let ((sign (aref string index)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
83 (if (or (eq sign ?+) (eq sign ?-))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
84 (setq sign (parse-time-string-chars sign)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
85 index (1+ index))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
86 (setq sign 1))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
87 (while (and (< index end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
88 (setq digit (digit-char-p (aref string index))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
89 (setq integer (+ (* integer 10) digit)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
90 index (1+ index)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
91 (if (/= index end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
92 (signal 'parse-error `("not an integer"
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
93 ,(substring string (or start 0) end)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
94 (* sign integer))))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
95
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
96 (defun parse-time-tokenize (string)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
97 "Tokenize STRING into substrings."
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
98 (let ((start nil)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
99 (end (length string))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
100 (all-digits nil)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
101 (list ())
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
102 (index 0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
103 (c nil))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
104 (while (< index end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
105 (while (and (< index end) ;skip invalid characters
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
106 (not (setq c (parse-time-string-chars (aref string index)))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
107 (incf index))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
108 (setq start index all-digits (eq c ?0))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
109 (while (and (< (incf index) end) ;scan valid characters
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
110 (setq c (parse-time-string-chars (aref string index))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
111 (setq all-digits (and all-digits (eq c ?0))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
112 (if (<= index end)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
113 (push (if all-digits (parse-integer string start index)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
114 (substring string start index))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
115 list)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
116 (nreverse list)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
117
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
118 (defvar parse-time-months '(("jan" . 1) ("feb" . 2) ("mar" . 3)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
119 ("apr" . 4) ("may" . 5) ("jun" . 6)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
120 ("jul" . 7) ("aug" . 8) ("sep" . 9)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
121 ("oct" . 10) ("nov" . 11) ("dec" . 12)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
122 (defvar parse-time-weekdays '(("sun" . 0) ("mon" . 1) ("tue" . 2)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
123 ("wed" . 3) ("thu" . 4) ("fri" . 5) ("sat" . 6)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
124 (defvar parse-time-zoneinfo `(("z" 0) ("ut" 0) ("gmt" 0)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
125 ("pst" ,(* -8 3600)) ("pdt" ,(* -7 3600) t)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
126 ("mst" ,(* -7 3600)) ("mdt" ,(* -6 3600) t)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
127 ("cst" ,(* -6 3600)) ("cdt" ,(* -5 3600) t)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
128 ("est" ,(* -5 3600)) ("edt" ,(* -4 3600) t))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
129 "(zoneinfo seconds-off daylight-savings-time-p)")
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
130
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
131 (defvar parse-time-rules
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
132 `(((6) parse-time-weekdays)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
133 ((3) (1 31))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
134 ((4) parse-time-months)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
135 ((5) (100 4038))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
136 ((2 1 0)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
137 ,#'(lambda () (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
138 (= (length parse-time-elt) 8)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
139 (= (aref parse-time-elt 2) ?:)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
140 (= (aref parse-time-elt 5) ?:)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
141 [0 2] [3 5] [6 8])
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
142 ((8 7) parse-time-zoneinfo
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
143 ,#'(lambda () (car parse-time-val))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
144 ,#'(lambda () (cadr parse-time-val)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
145 ((8)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
146 ,#'(lambda ()
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
147 (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
148 (= 5 (length parse-time-elt))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
149 (or (= (aref parse-time-elt 0) ?+)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
150 (= (aref parse-time-elt 0) ?-))))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
151 ,#'(lambda () (* 60 (+ (parse-integer parse-time-elt 3 5)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
152 (* 60 (parse-integer parse-time-elt 1 3)))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
153 (if (= (aref parse-time-elt 0) ?-) -1 1))))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
154 ((5 4 3)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
155 ,#'(lambda () (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
156 (= (length parse-time-elt) 10)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
157 (= (aref parse-time-elt 4) ?-)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
158 (= (aref parse-time-elt 7) ?-)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
159 [0 4] [5 7] [8 10])
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
160 ((2 1 0)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
161 ,#'(lambda () (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
162 (= (length parse-time-elt) 5)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
163 (= (aref parse-time-elt 2) ?:)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
164 [0 2] [3 5] ,#'(lambda () 0))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
165 ((2 1 0)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
166 ,#'(lambda () (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
167 (= (length parse-time-elt) 4)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
168 (= (aref parse-time-elt 1) ?:)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
169 [0 1] [2 4] ,#'(lambda () 0))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
170 ((2 1 0)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
171 ,#'(lambda () (and (stringp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
172 (= (length parse-time-elt) 7)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
173 (= (aref parse-time-elt 1) ?:)))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
174 [0 1] [2 4] [5 7])
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
175 ((5) (50 110) ,#'(lambda () (+ 1900 parse-time-elt)))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
176 ((5) (0 49) ,#'(lambda () (+ 2000 parse-time-elt))))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
177 "(slots predicate extractor...)")
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
178
52623
0edad246b289 (parse-time-string): Add autoload cookie.
André Spiegel <spiegel@gnu.org>
parents: 52401
diff changeset
179 ;;;###autoload
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
180 (defun parse-time-string (string)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
181 "Parse the time-string STRING into (SEC MIN HOUR DAY MON YEAR DOW DST TZ).
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
182 The values are identical to those of `decode-time', but any values that are
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
183 unknown are returned as nil."
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
184 (let ((time (list nil nil nil nil nil nil nil nil nil))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
185 (temp (parse-time-tokenize (downcase string))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
186 (while temp
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
187 (let ((parse-time-elt (pop temp))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
188 (rules parse-time-rules)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
189 (exit nil))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
190 (while (and (not (null rules)) (not exit))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
191 (let* ((rule (pop rules))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
192 (slots (pop rule))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
193 (predicate (pop rule))
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
194 (parse-time-val))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
195 (when (and (not (nth (car slots) time)) ;not already set
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
196 (setq parse-time-val (cond ((and (consp predicate)
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
197 (not (eq (car predicate)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
198 'lambda)))
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
199 (and (numberp parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
200 (<= (car predicate) parse-time-elt)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
201 (<= parse-time-elt (cadr predicate))
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
202 parse-time-elt))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
203 ((symbolp predicate)
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
204 (cdr (assoc parse-time-elt
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
205 (symbol-value predicate))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
206 ((funcall predicate)))))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
207 (setq exit t)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
208 (while slots
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
209 (let ((new-val (and rule
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
210 (let ((this (pop rule)))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
211 (if (vectorp this)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
212 (parse-integer
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
213 parse-time-elt
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
214 (aref this 0) (aref this 1))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
215 (funcall this))))))
48411
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
216 (rplaca (nthcdr (pop slots) time)
827133772385 (parse-time-elt): Var renamed from `elt'.
Richard M. Stallman <rms@gnu.org>
parents: 43048
diff changeset
217 (or new-val parse-time-val)))))))))
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
218 time))
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
219
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
220 (provide 'parse-time)
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
221
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 48411
diff changeset
222 ;;; arch-tag: 07066094-45a8-4c68-b307-86195e2c1103
43048
ebb4fa093863 Moved parse-time.el from lisp/gnus to lisp/calendar.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
223 ;;; parse-time.el ends here