IN-HEH © Calendar - Command line

[Français]
IN-HEH © Calendar allows date conversion for different calendars such as julian, gregorian and french. The current version is a freeware and can be downloaded under following page.

Table of Contents

Present page aims at describing the IN-HEH Calendar command line version.

Overall Description

[Index] [Top]

Command line interface allows flexible integration of the converter in a user script. It allows also conversion of a list of dates provided within a text file. Dates can be handled in many different user-defined formats for either input or output.

Interface Description

[Index] [Top]

ihc (-jdn <jdn>|-input <input-date>|-input-file <input file>) -input-calendar <input-calendar> -output-calendar <output-calendar> [-input-format <input-format>] [-output-file <output-file-name>] [-output-format <output-format>] [-no-copyright] [-no-format] Supported calendars are: julian, gregorian, indian, french Default date format: ADYYYY:MM:DD IN-HEH Calendar converter 0.2.0 - http://www.in-heh.com Copyright (C) 2006 IN-HEH Ch.Pardon. All rights reserved. contact: postmaster@in-heh.com

Table 1: Arguments list.
Argument Mandatory Description
-input <input date> Mandatory if none -input-file or -jdn is provided. Input date to be converted. The argument must be compliant with input format.
-input-calendar <input calendar> Mandatory except if -jdn is used or -input-format is "JDN". Input date calendar. Must be set with one of the values: gregorian, julian, indian, french.
-input-file <input file name> Mandatory if none of -input or -jdn is provided. File name containing a list of date to be converted. Dates within the file must be compliant with input format. One date per line.
-input-format <input format> Optional (default ADYYYY:MM:DD) Input format compliant with description.
-jdn <julian day number> Mandatory if none -input or -input-file is provided. Julian day number (decimal integer format).
-no-copyright Optional Do not display copyright notice with the result.
-no-format Optional Do not display output format along with output date.
-output-calendar <output calendar> Mandatory Output date calendar. Refer to -input-format parameter for allowed values.
-output-file <output file name> Optional Define output file name to store converted dates. By default the output are displayed in standard output.
-output-format <output format> Optional (default ADYYYY:MM:DD) Output format compliant with description.

Date Format

[Index] [Top]

Date format is a combination of character delimiters (Table 2) and predefined keywords (Table 3), such as:
"YYYY/MM/DD" or "JDN".

Supported delimiters are listed in table below:

Table 2: Date Format delimiters.
Character Delimiters
. : , ;
[ ] ( )
{ } _ =
/ \ | <space>
+ - * %

Supported format keywords are listed in table below. Column I/O tells if keyword in allowed in input and output date format (I/O) or output only (O).

Table 3: Date Formats.
Key Description I/O
ADCC Stringified roman century with AD/BC mentions. O
ADYYYY 4-digits Anno Domini year. I/O
CC Stringified roman century (signed). O
DD 2-digits day of the month [01;31]. I/O
DW Stringified day of the week (english language). O
SDW Day of the week number [0;6], 0 is sunday. O
DY Day of the year [1;366]. O
SDY Stringified day of the year. Enabled for french calendar only. O
JDN Julian day number. I/O
M Month initial {J,F,M,A,M,J,J,A,S,O,N,D}. O
MM 2-digits month number [01;12]. I/O
WW 2-digits week number [01;53]. O
SWW 2-digits week number with perfix 'W' [W01;W53]. O
SADYYYY 4-digits Anno Domini year (with AD/BC mentions and no year 0). O
YY 2-digits year. I/O
YYYY 4-digits year. I/O

Feature List Version 0.2

[Index] [Top]