.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.38.2.
.\"     *
.\"     * jcal.1 - Unix cal-like interface to libjalali.
.\"     * Copyright (C) 2006, 2007, 2009, 2010, 2011 Ashkan Ghassemi.
.\"     *
.\"     * This file is part of jcal.
.\"     *
.\"     * jcal is free software: you can redistribute it and/or modify
.\"     * it under the terms of the GNU General Public License as published by
.\"     * the Free Software Foundation, either version 3 of the License, or
.\"     * (at your option) any later version.
.\"     *
.\"     * jcal is distributed in the hope that it will be useful,
.\"     * but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"     * GNU General Public License for more details.
.\"     *
.\"     * You should have received a copy of the GNU General Public License
.\"     * along with jcal.  If not, see <http://www.gnu.org/licenses/>.
.\"     *

.TH JDATE "1" "Khordad 6, 1390" "jdate" "User Commands"
.SH NAME
jdate \- manual page for jdate
.SH SYNOPSIS
.B jdate
[\fIarRuhV\fR]... [\fI+OUTPUT_FORMAT\fR][\fId INPUT_FORMAT;DATE_STRING\fR]
.SH DESCRIPTION
Display the current date and time in the given FORMAT.
.TP
\fB\-d\fR, \fB\-\-date\fR=\fIFORMAT\fR;STRING
display time described by STRING, not `now'
.TP
\fB\-a\fR, \fB\-\-access\fR=\fIFILE\fR
display the last access time of FILE.
.TP
\fB\-r\fR, \fB\-\-reference\fR=\fIFILE\fR
display the last modification time of FILE.
.TP
\fB\-j\fR, \fB\-\-jalali\fR=\fI%Y\fR/\fI%m\fR/\fI%d\fR
converts a gregorian date to jalali.
.TP
\fB\-g\fR, \fB\-\-gregorian\fR=\fI%Y\fR/\fI%m\fR/\fI%d\fR
converts a jalali date to gregorian.
.TP
\fB\-R\fR, \fB\-\-rfc\-2822\fR
output date and time in RFC 2822 format.
Example: Jom, 06 Khor 1390 13:44:56 \fB\-0430\fR.
.TP
\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR
print Coordinated Universal Time.
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
output version information and exit.
.TP
FORMAT controls the output.
Interpreted sequences are:
.TP
%%
a literal %
.TP
%a
abbreviated weekday name (e.g., Sun)
.TP
%A
full weekday name (e.g., Sunday)
.TP
%b
abbreviated month name (e.g., Khor)
.TP
%B
full month name (e.g., Khordad)
.TP
%c
date and time (e.g., Jome Kho  6 17:18:25 1390)
.TP
%C
century; like %Y, except omit last two digits (e.g., 13)
.TP
%d
day of month (e.g., 01)
.TP
%D
date; same as %Y/%m/%d
.TP
%e
day of month, space padded; same as %_d
.TP
%E
date and time in Farsi. (utf8)
.TP
%F
full date; same as %Y\-%m\-%d
.TP
%h
abbreviated Farsi weekday name in English transliteration (e.g. Jom)
.TP
%q
full Farsi weekday name in English transliteration (e.g. Jomeh)
.TP
%g
abbreviated Farsi weekday name. (utf8)
.TP
%G
full Farsi weekday name. (utf8)
.TP
%v
abbreviated Farsi month name. (utf8)
.TP
%V
full Farsi month name. (utf8)
.TP
%H
hour (00..23)
.TP
%I
hour (01..12)
.TP
%j
day of year (001..366)
.TP
%k
hour (0..23)
.TP
%l
hour (1..12)
.TP
%m
month (01..12)
.TP
%M
minute (00..59)
.TP
%n
a newline
.TP
%O
AM or PM notation for time in Farsi. (utf8)
.TP
%p
either AM or PM; blank if not known
.TP
%P
like %p, but lower case
.TP
%r
12\-hour clock time (e.g., 17:24:04 PM)
.TP
%R
24\-hour hour and minute; same as %H:%M
.TP
%s
seconds since 1970\-01\-01 00:00:00 UTC
.TP
%S
second (00..59)
.TP
%t
a tab
.TP
%T
time; same as %H:%M:%S
.TP
%u
day of week (1..7); 1 is Saturday
.TP
%U
week number of year, with Saturday as first day of week (00..53)
.TP
%w
day of week (0..6); 0 is Saturday
.TP
%W
date representation in Farsi. (utf8)
.TP
%x
date representation (e.g., 06/03/90)
.TP
%X
time representation in Farsi. (utf8)
.TP
%y
last two digits of year (00..99)
.TP
%Y
year
.TP
%z
+hhmm numeric time zone (e.g., +0330)
.TP
%Z
alphabetic time zone abbreviation (e.g., IRST)
.SH EXAMPLES
.TP
jdate -uR
formats current UTC date and time in RFC2822 format.
.TP
jdate '+%Y-%m-%d %H:%M:%S'
formats current local date and time in the above format. e.g. 1390-03-06 21:12:17
.TP
jdate --access=foo.bar
displays last access time for file foo.bar
.TP
jdate '+%s' --date='%Y/%m/%d-%H:%M:%S;1390/03/06-21:14:17'
displays seconds since epoch (UTC) for local date specified by date string.
.SH AUTHOR
Written by Ashkan Ghassemi. <ghassemi@ftml.net>
.SH REPORTING BUGS
Report jdate bugs to <ghassemi@ftml.net>

libjalali home page: <http://savannah.nongnu.org/projects/jcal/>
.SH "SEE ALSO"
.BR jcal (1),
.BR jctime (3),
.BR jstrftime (3),
.BR jstrptime (3)
.SH COPYRIGHT
Copyright (C) 2011 Ashkan Ghassemi.

License GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by
law.