DateCalculator 2.4 : Manual

Table of contents

You must have JavaScript enabled in your browser to generate the table of contents.

1  Introduction

DateCalculator is a Java application that performs calculations on calendar dates. It can perform three functions:

DateCalculator uses the Gregorian calendar for all dates, and it accepts input dates between the years 1600 CE and 3999 CE. Dates output by DateCalculator are displayed in user-defined formats. In those formats, the names of days and months may be obtained from a Java locale (a language, or a language and a country) or they may be user-defined.

DateCalculator is distributed under version 3 of the GNU General Public License; for details, see the file license.txt that is included in the DateCalculator distribution.

The website of the DateCalculator project is at http://datecalculator.sourceforge.net/ .

2  Requirements

DateCalculator is a Java application that requires a Java runtime environment that supports Java SE 7 (Java 1.7), such as Oracle's Java Runtime Environment (JRE), version 7 or later.

3  Contents of the distribution

The following files are included in the distribution:

dateCalculator.jar The executable JAR (Java archive) file of the DateCalculator application.
dateCalculator-config.xml The configuration file for DateCalculator, which contains the default values for the configuration properties.
license.txt A copy of the licence under which DateCalculator is distributed (GNU General Public License, version 3).
images/dateCalculator.png
images/dateCalculator.ico
A 48×48-pixel PNG image and a 48×48-pixel Windows-format icon that can be used to customise a desktop icon for the DateCalculator application.
manual/manual.html
manual/images/*.png
manual/scripts/*.js
manual/style/*.css
This manual, its image files, scripts and stylesheets. Any modifications to the manual for the latest version of DateCalculator will appear in the online version of the document, to which there is a link on the DateCalculator website.

4  Installing and running DateCalculator

DateCalculator consists of a single JAR (executable Java archive) file, dateCalculator.jar and a configuration file, dateCalculator-config.xml, which contains user preferences. The use of the configuration file is optional but recommended. The application can be installed in two ways: with the DateCalculatorInstaller program or by copying files from the .zip or .tar.gz archive of the DateCalculator executable distribution.

4.1  Executing a JAR file

Both the DateCalculator application and the installer are executable JAR (Java archive) files that require a Java runtime environment, which includes a program named java for running JAR files — a Java launcher. When you install a Java runtime environment, it may create an association on your system between JAR files and its Java launcher. (Oracle's Java runtime environment on Windows associates JAR files with an additional Java launcher named javaw that runs without a console window.) If so, or if you have created the association yourself, you will be able to run a JAR file directly (eg, by double-clicking on an icon of the JAR file in a file manager). If not, you can run a JAR file by invoking the java launcher tool from a command line and supplying the location of the JAR file as an argument. There are examples below of command lines for running the JAR file of the DateCalculator application under Linux/UNIX and Windows.

4.2  Installing DateCalculator

4.2.1  Installation with the installer program

The installer is an executable JAR (Java archive) file that requires the same Java runtime environment as the DateCalculator application itself. It can be run directly or indirectly in the ways described above.

In the opening display of the installer, you can choose the components that you want to install and the directories in which they will be installed. It is recommended that you install the configuration file in its default directory; the default directories of the other components should also be suitable for most users. If you install the executable file and the configuration file, a file named dateCalculator-properties.xml will be generated and written to the same directory as the executable file to inform the DateCalculator application of the location of the configuration file. This file is required only if the configuration file was not installed in the default directory.

Any existing file that has the same name as an installed file will be overwritten without warning except for a configuration file, whose properties will be preserved if they conflict with the properties of the new file.

The final display of the installer has a Show files command that displays a list of files that were installed. If the installation was successful, you might want to keep a list of the files so that you will know where to find them when you uninstall DateCalculator, which does not have an automated means of uninstallation. If the installation failed, you might want to remove any files that were installed.

4.2.2  Direct installation

The direct installation of DateCalculator consists simply of copying the JAR file and, optionally, the default configuration file to suitable locations on your system. If the configuration file is not installed in its default directory, you will need to inform the DateCalculator application of the location of the configuration file, which can be done either on the command line or in a properties file.

4.3  Running DateCalculator

The DateCalculator application is an executable JAR (Java archive) file that requires a Java runtime environment. The JAR file can be run directly or indirectly in the ways described above.

If you run the DateCalculator application from a command line, the command line may contain configuration properties, including the location of a configuration file. The following subsections describe how to run DateCalculator from a command line.

4.3.1  Running under Linux/UNIX

Assuming that your PATH environment variable includes the path to the java tool and that you have copied dateCalculator.jar to the directory /home/slothrop/bin/datecalculator/, the command

java -jar /home/slothrop/bin/datecalculator/dateCalculator.jar

will run the DateCalculator application.

The file dateCalculator.png can be used as the icon for the DateCalculator application.

4.3.2  Running under Windows

The DateCalculator application does not require a console window, so you can use the javaw launcher rather than the java launcher unless you particularly want a console window. Assuming that your PATH environment variable includes the path to the javaw tool and that you have copied dateCalculator.jar to the directory C:\Program Files\DateCalculator\, the command

javaw -jar "C:\Program Files\DateCalculator\dateCalculator.jar"

will run the DateCalculator application.

The file dateCalculator.ico can be used as the icon for the DateCalculator application.

4.4  Uninstalling DateCalculator

DateCalculator does not have an automated means of uninstallation. To remove it from your system, delete the file dateCalculator.jar from the location to which it was written when you installed DateCalculator. If you want to remove DateCalculator completely, you should also delete the configuration file, dateCalculator-config.xml, which may be at its default location, and any other files that were installed (eg, the manual).

5  Configuration

When it starts up, DateCalculator is configured with configuration properties that are read from two sources: the command line that is used to run the Java launcher and a configuration file whose location may be explicitly specified. If the same property is specified on the command line and in a configuration file, the value from the configuration file takes precedence.

The recommended method of setting the properties in a configuration file is with the Preferences command. For command-line properties, which must be edited manually, the form of the property values is given in an appendix, and it can also be inferred by generating a configuration file with the desired values and inspecting the contents of the file.

5.1  Command-line properties

When DateCalculator is run by means of the java launcher, configuration properties may be specified on the command line using the standard Java form -Dname="value"; eg, -Dapp.date.firstDayOfWeek="2". (The quotation marks around the value aren't necessary if the value doesn't contain spaces.) DateCalculator's command-line configuration properties all have the prefix app. . A list of all the properties that are recognised by DateCalculator is given in an appendix.

One particular property, app.configDir, is used to specify the directory that contains a configuration file, as described below. The value of the app.configDir property may contain special constructions for system properties, environment variables and the user's home directory.

5.2  Configuration file

The configuration file is named dateCalculator-config.xml. DateCalculator doesn't require a configuration file: it uses a default value for any configuration property that is missing from the source(s) of configuration. Similarly, if it finds a property value to be invalid, DateCalculator will display a message to this effect and use the default value of the property. If the configuration file contains a property that was specified on the command line, the value from the configuration file is used.

If the configuration has changed when you exit the application normally (ie, using the Exit command or an equivalent), DateCalculator will save its configuration to a configuration file. If a configuration file was read on startup, it will overwrite that file; otherwise, it will write a configuration file to the default directory described above, unless the value of the app.configDir property was an empty string.

A configuration file can be written explicitly with the Save configuration command within the Preferences dialog.

5.2.1  Location of the configuration file

When it starts up, DateCalculator is informed of the location of the configuration file with the app.configDir property, which may be set in two ways:

If the app.configDir property is set both in the properties file and on the command line, the value in the properties file takes precedence.

The dateCalculator-properties.xml file is normally written by the installer. If you create the file manually, it should have the following form, with the example pathname replaced by the actual pathname:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="app.configDir">/home/slothrop/.blankaspect/dateCalculator</entry>
</properties>

If the configuration file were located in a directory named config in the user's home directory, the sample command lines given above would become:

Linux/UNIX: java -Dapp.configDir="~/config" -jar /home/slothrop/bin/datecalculator/dateCalculator.jar
Windows: javaw -Dapp.configDir="~/config" -jar "C:\Program Files\DateCalculator\dateCalculator.jar"

The existence and value of the app.configDir property determines the locations that are searched for a configuration file:

6  Locales

A Java runtime environment has one or more locales, which are a mechanism by which a Java application can obtain information to adapt itself for different languages and regions — a practice known as localisation. This section describes the few ways in which DateCalculator uses the information provided by locales.

Localisation in DateCalculator is confined to the names of months, the names of days of the week and the identity of the first day of the week. Western numerals — also called Arabic numerals in English — are used exclusively for numbers in dates. More broadly, the user interface has no support for languages that are not written left-to-right, top-to-bottom.

6.1  The default locale

When a Java application starts up, the Java environment sets a default locale, which is determined from the operating system. DateCalculator uses this locale for

6.2  The locale for names of months and days of the week

A locale may be selected as the source of the names of months and days of the week that are used by DateCalculator's date formats. This locale may be different from the default locale.

7  Calendars and dates

7.1  The Gregorian calendar

DateCalculator uses a pure Gregorian calendar for all dates: there is no point at which dates switch to the Gregorian calendar from its predecessor, the Julian calendar. This simplifies the handling of dates by DateCalculator at the cost of reducing its usefulness for historical dates.

The Gregorian calendar was adopted at different times by different countries and regions. The Wikipedia article on the Gregorian calendar has two pieces of information that allow you to work out, for a given year and country, the number of days that you should subtract from a Gregorian date to convert it to a Julian date:

According to Wikipedia, there were some local complications in the transition from the Julian to the Gregorian calendar, so the conversion between calendars will not be straightforward in all cases.

DateCalculator accepts input dates between the years 1600 CE and 3999 CE, though it will display results outside this range.

7.2  Names of months and days of the week

DateCalculator uses names of months and days of the week in two places: the date selection dialog and the formatted dates that are output by the increment and interval functions.

In the date selection dialog, the names of months and days of the week are those for the default locale. The names of months are abbreviated to the first three or more characters; the names of days are abbreviated to the first two or more characters.

The sources of the formatted dates are described in the section on date formats.

7.3  Date formats

The dates that are output by DateCalculator's increment and interval functions are formatted with one of the user-defined formats. A date format consists of a pattern, which determines how the date will appear, and a name, which is just an alias for the pattern, to allow you to select it more easily from a list.

A pattern can contain two kinds of element: literal text and fields. The formatter leaves literal text unchanged but replaces fields with the appropriate component of the date — year, month or day. The month and day fields can be either a number or a name. The width (number of characters) and alignment (left or right) of a field can be specified. A field whose content is smaller than its specified width will be padded with spaces or, if it is a number field, optionally with zeros. A field whose content is larger than its specified width will be truncated.

For a name field, the names of months and days of the week are obtained either from a selected locale or, if the names from the locale are not acceptable, from lists of user-defined names of months and days of the week. The date.namesSource configuration property determines whether the names are obtained from a locale or whether they're user-defined.

In a pattern, a field starts with a % character. This may be followed by the special characters [ or ], which denote left and right alignment respectively, and by a decimal number to denote the width of the field. (Fields are left-aligned by default, so the left-alignment prefix is unnecessary.) The field ends with a letter that identifies the kind of field.

A maximum of 64 date formats can be defined. Neither the name nor the pattern of a date format may contain the string ## because it is used in the configuration property as the separator between the name and pattern.

The following tables describe the form and meaning of fields in a pattern:

Field identifiers
y year
m month (number)
M month (name)
d day (number)
D day (name)
Field prefixes
n is a decimal number between 1 and 999 denoting the width of the field in characters
% implicit width
%n width n, left-aligned (ie, padded to the right with spaces)
%0n width n, padded with leading zeros
%[n width n, left-aligned (ie, padded to the right with spaces)
%]n width n, right-aligned (ie, padded to the left with spaces)
Other
%% literal '%' character

7.3.1  Examples of date formats

The following examples are all representations of the date 4 October 1986. The names of months and days of the week are those for the en-GB locale.

Pattern Formatted output
%04y-%02m-%02d 1986-10-04
%D, %d %M %y Saturday, 4 October 1986
%2d %3M %y  4 Oct 1986
%m/%d/%y 10/4/1986
"%3D %3M %02d" "Sat Oct 04"
%02d/%02m/%02y (%D) 04/10/86 (Saturday)
%02d.%02m.%02y [%]10D] 04.10.86 [  Saturday]
%2d%%%2m%%%4y  4%10%1986

8  The display

8.1  The main window

DateCalculator's main window is equivalent to a dialog box. The size of the window cannot be changed directly, though it may change as a side-effect of changing the fonts in the user preferences.

The main window is tabbed, with a tab for each of the three functions of the application: Increment (adding a number of days to a date or subtracting a number of days from a date), Difference (calculating the number of days between two dates) and Interval (generating a list of dates with a specified number of days between successive pairs of dates).

8.1.1  The Increment tab

The increment function adds a number of days to a date or subtracts a number of days from a date.

The Date field, a compound date field, holds the input date. The button to the right of the field brings up a date selection dialog in which you can select the date. The Today button to its right sets the date to the current date.

The Days spinner specifies the number of days that will be added to or subtracted from the date in the Date field.

The Date format drop-down list selects the format that is used for the result. The items in the list are the names of the date formats. When the list is displayed, the pattern associated with an item in the list is displayed as a tooltip when the mouse cursor hovers over the item.

The result of the calculation is displayed in the Result field. The Copy button to the right of the field copies the result to the system clipboard. The button with an upward-pointing arrow to the right of the Copy button sets the Date field to the result, facilitating chained calculations.

The buttons for the Add and Subtract commands are enabled when none of the three subfields of the Date field is empty. When the Add or Subtract command is issued, the Date field is validated and an error message displayed if the date is invalid. If the date is valid, the addition or subtraction is performed and the Result field is updated with the result.

8.1.2  The Difference tab

The difference function calculates the number of days from one date to another.

The Start date and End date fields are compound date fields that hold, respectively, the start and end dates. The button to the right of each field brings up a date selection dialog in which you can select the date. The Today button to its right sets the date to the current date.

The result of the calculation — the number of days from the start date to the end date — is displayed in the Result field; if the start date is after the end date, the result will be negative. The Copy button to the right of the field copies the result to the system clipboard.

The button for the Subtract command is enabled when none of the subfields of the Start date and End date fields is empty. When the Subtract command is issued, the Start date and End date fields are validated and an error message displayed if either date is invalid. If the dates are valid, the subtraction is performed and the Result field is updated with the result.

8.1.3  The Interval tab

The interval function generates a sequence of dates with a given number of days between each successive pair of dates.

The Start date field, a compound date field, holds the first date in the sequence. The button to the right of the field brings up a date selection dialog in which you can select the date. The Today button to its right sets the date to the current date.

The Interval spinner specifies the number of days between successive dates in the sequence.

There are three ways to specify the end of the sequence:

The choice is controlled by radio buttons, each of which enables its adjacent components when it is selected.

The Date format drop-down list selects the format that is used for the result. The items in the list are the names of the date formats. When the list is displayed, the pattern associated with an item in the list is displayed as a tooltip when the mouse cursor hovers over the item.

The button for the Generate command is enabled when none of the subfields of the Start date field — and the subfields of the End date field, if it is enabled — is empty. When the Generate command is issued, the date fields are validated and an error message displayed if a date is invalid. If the dates are valid, the sequence of dates is generated and displayed in the selected format, one date per line, in a dialog box. In the results dialog, the Copy command copies the list of dates to the system clipboard.

8.2  Graphical components

DateCalculator's user interface has some non-standard graphical components and some standard components that have bespoke features.

8.2.1  Spinner

A spinner is a graphical component for editing a numerical value. It consists of a text field adjacent to a pair of small buttons. The value in the text field may be edited manually, or it may be incremented and decremented by one of the following methods:

Using the last two methods, the amount by which the value is incremented or decremented can be modified by holding down the Ctrl, Shift or Ctrl+Shift keys, which correspond to increments of 10, 100 and 1000 respectively.

8.2.2  Compound date field

A compound date field is a group of three text fields for editing a date. From left to right, the three fields are year, month and day. The three subfields accept only decimal digits: the year field accepts four digits while the month and day fields both accept two digits.

8.2.3  Date selection dialog

To the right of each compound date field is a button with an icon that is intended to represent a page from a calendar. This button brings up a dialog box in which you can select a date. If there is a valid date in the adjacent compound date field, that date is selected when the dialog is displayed.

The arrow buttons at the top of the dialog are for moving through the months of the calendar: the single-arrow buttons move to the previous or next month; the double-arrow buttons move to the previous or next year.

Between the two sets of arrow buttons is a label indicating the current month and year. (The month is denoted by the first three or more characters of its name.) If you click the left mouse button on the label or press Ctrl+Space, a further dialog box is displayed in which you can edit the month and year.

The main panel of the date selection dialog has the customary form of a month from a calendar: a table whose columns are the seven days of the week. The headers of the column are the first two or more characters of the names of the days of the week. If you press the left mouse button over a column header, the full name of the day is displayed in a pop-up box.

You can use the left mouse button to select a day from the current month; the selection cursor will follow the mouse cursor as you drag the mouse. Double-clicking on a day will select the date and accept the dialog (ie, it will close the dialog as though the OK command were issued). If the dialog is accepted, the adjacent compound date field will be updated with the selected date.

The following keys can be used to navigate the date selection dialog:

Left Select the previous day in the current row
Right Select the next day in the current row
Home Select the first day in the current row
End Select the last day in the current row
Up Select the previous day in the current column
Down Select the next day in the current column
Ctrl+Home Select the first day in the current column
Ctrl+End Select the last day in the current column
PageUp Move to the previous month
PageDown Move to the next month
Ctrl+PageUp Move to the previous year
Ctrl+PageDown Move to the next year
Ctrl+Space Edit the month and year

9  Commands

DateCalculator's main commands are issued from the buttons at the bottom of its main window. The tabs of the main window have their own commands, which are described in the sections on the Increment tab, Difference tab and Interval tab.

9.1  Preferences

The Preferences command brings up a tabbed dialog box in which the configuration properties of DateCalculator can be edited. The properties on the various tabbed pages are described below.

General
Display UNIX-style pathnames
If you select Yes, pathnames are displayed in a reduced "UNIX style" in error messages relating to the configuration file. A pathname is converted from its platform-specific form in two steps:
  1. If the pathname starts with the user's home directory, the latter is replaced by '~'.
  2. The file-separator character ('\' on Windows systems) is replaced by '/'.
The default value is No.
Select text when focus is gained
If you select Yes, all the text in a text field will be automatically selected when the field gains keyboard focus, regardless of how the focus is transferred.
The default value is Yes.
Save location of main window
If you select Yes, the location of the main window on the screen will be saved to the configuration file when you exit the application. The next time that DateCalculator is run, its main window will be positioned at the previously saved location.
The default value is Yes.
Appearance
Look-and-feel
The look-and-feel (LAF) can be selected from a list of the LAFs that are available on the current system.
The default value is the cross-platform LAF, currently called Metal.
Text antialiasing
This determines the kind of antialiasing that is performed when text is drawn in custom or partially customised user-interface components (eg, in drop-down lists). Note that antialiasing is only a hint in Java; the implementation is not required to perform the chosen antialiasing.
This property has no effect on the antialiasing of text in standard UI components, such as labels and menus, which is determined by the Java implementation and the desktop setting for antialiasing text (often referred to as "font smoothing"). You can override the desktop setting with the unsupported system property awt.useSystemAAFontSettings.
The text antialiasing property can have the following values:
Default
The desktop setting for text antialiasing (font smoothing) is used, if the Java implementation recognises one; otherwise, no antialiasing is performed.
None
No antialiasing is performed.
Standard
This selects pixel-oriented antialiasing rather than subpixel antialiasing. It is suitable for non-LCD displays.
Subpixel, horizontal RGB
Subpixel, horizontal BGR
Subpixel, vertical RGB
Subpixel, vertical BGR
These four options are intended to optimise the rendering of text for LCD displays using subpixel antialiasing with subpixels in the chosen arrangement. Selecting an option that does not correspond to the actual arrangement of subpixels in your LCD display may result in blurred text. The most common arrangement of subpixels is horizontal RGB.
The default value is Default.
Date
Date formats
These are the formats that can be applied to the dates that are output by DateCalculator's increment and interval functions. The formats are displayed in a list box. A maximum of 64 date formats can be defined.
A date format consists of a name and a pattern; in the list box, the name is in the left column and the pattern is in the right column. The list can be edited with the Add, Edit and Delete commands, which are issued with the buttons adjacent to the list box. You can change the order of items in the list by dragging an item to a new position with the mouse, or by pressing Ctrl+Shift+Up or Ctrl+Shift+Down when the list has keyboard focus.
The Add and Edit commands bring up a dialog box in which the name and pattern of a date format can be edited. Neither the name nor the pattern of a date format may contain the string ## because it is used in the configuration property as the separator between the name and pattern.
If no date formats are defined, a default format named Default, with the pattern %04y-%02m-%02d, is available from Date format drop-down lists.
Source of names of months & days of the week
This determines whether the names of months and days of the week in the dates output by DateCalculator are obtained from a specified locale (a language, or a language and country) or defined by the user. If Locale is selected, the names are obtained from the locale specified by the date.namesLocale configuration property; if User-defined is selected, the names are obtained from the user-defined lists of names of months and days of the week.
The default value is Locale.
Locale for names of months & days of the week
This is the locale that is used as the source for names of months and days of the week if the date.namesSource configuration property is set to Locale. The drop-down list contains the names of all the available locales. The names are in an abbreviated form: all locales have a two-letter, lower-case ISO 639-1 language code followed in some cases by a hyphen and a two-letter, upper-case ISO 3166-1 country code. (In a few cases, the country code is followed by another hyphen and a variant code.) At the top of the list is the special value, <default locale>, which identifies the default locale.
When the drop-down list is displayed, a more descriptive name for each locale is displayed as a tooltip when the mouse cursor hovers over the item in the list.
The default value is <default locale>.
User-defined names of months
If you issue the Edit months command, a dialog box will be displayed in which you can edit the names of months. Within the dialog, the Set from locale command sets the names of all the months to their names for the default locale.
The default value of the name of each month is the empty string.
User-defined names of days of the week
If you issue the Edit days command, a dialog box will be displayed in which you can edit the names of days of the week. Within the dialog, the Set from locale command sets the names of all the days to their names for the default locale.
The default value of the name of each day of the week is the empty string.
First day of the week
This value is used to determine the first day of the week for the columns in the date selection dialog. If you select <default>, the first day of the week will be that for the default locale, which, for example, is Monday in the UK and Sunday in the USA.
The default value is <default>, which uses the value for the default locale.
Fonts
These are the fonts that are used in DateCalculator's display. Remember that font names may be platform-dependent, so that a configuration that specifies font names may not work across platforms.
The main font is used for various components including labels (static text), menus, buttons and list boxes.
The text field font is used for text fields, spinners and some other text components.
The combo box font is used for drop-down lists and related components.
The default values of all the font properties are those of the default fonts for the platform and look-and-feel. A default font size is specified by leaving the Size field empty (the minimum position on the spinner). A default font is used if no font name is specified in DateCalculator's configuration or if the named font is not available.

Some of the configuration properties will take effect when the Preferences dialog is accepted (by closing it with OK); other properties (eg, the look-and-feel and fonts) will not take effect until the next time that DateCalculator is run.

The configuration file is normally saved automatically when DateCalculator exits, if the configuration has changed. The Save configuration command in the Preferences dialog can be used to save a configuration file explicitly.

9.2  Exit

This command terminates the application.

Appendix A:  Special constructions in pathnames

The app.configDir configuration property can contain special constructions for system properties, environment variables and the user's home directory. The special constructions are expanded when the pathname is used.

System properties and environment variables
Java system properties (eg, the user's home directory, user.home) and environment variables (eg, PATH) are referenced by enclosing them between '${' and '}'; that is, they must have the form ${<name>}. A Java system property takes precedence over an environment variable with the same name.
• Example: ${user.home}/projects
• Example: ${HOME}/projects
A Java system property can be specified by prefixing sys. to it.
• Example: ${sys.user.home}/projects
An environment variable can be specified by prefixing env. to it.
• Example: ${env.HOME}/projects
User's home directory
A leading '~' in a pathname is expanded into the user's home directory using the user.home system property, which is usually equivalent to the environment variable $HOME on Linux/UNIX systems or %USERPROFILE% on Windows systems.
• Example: ~/projects

Appendix B:  Configuration properties

The table below lists the configuration properties of DateCalculator. Apart from the app.configDir property, which, for obvious reasons, cannot be used within a configuration file, all properties can be used in the two configuration locations: command-line properties and configuration file.

When used in a -D command-line property, app. must be prefixed to the property key (eg, app.general.mainWindowLocation).

Any commas (',') or backslash characters ('\') in the name of a font must be escaped by prefixing a '\' character to them.

In the table below, the initial character of an italicised component of a property value denotes its data type according to the following convention:

i integer
p platform-specific pathname, which may contain special constructions
s string
Property key Property value
configDir pPathname
appearance.lookAndFeel sName
appearance.textAntialiasing default | none | normal | subpixelHRgb | subpixelHBgr | subpixelVRgb | subpixelVBgr
date.dayName.<index> sName
date.firstDayOfWeek iIndex
date.format.<index> sName##sPattern
date.monthName.<index> sName
date.namesLocale sLocale
date.namesSource locale | userDefined
font.comboBox sName, plain | bold | italic | boldItalic, iSize
font.main sName, plain | bold | italic | boldItalic, iSize
font.textField sName, plain | bold | italic | boldItalic, iSize
general.mainWindowLocation iX, iY
general.selectTextOnFocusGained false | true
general.showUnixPathnames false | true

Appendix C:  Providing feedback about DateCalculator

The DateCalculator project is hosted by SourceForge. You can submit bug reports, feature requests and suggestions for improvement through the SourceForge website, but the mechanism for doing so may change depending on the facilities that SourceForge provides. For current information, please see the feedback page for Blank Aspect projects.

When reporting a problem with DateCalculator, please try to include enough relevant information to enable the problem to be reproduced. You should include at least the following information:

A Java stack trace, if one is available, would be helpful.

Last modified: 2014-10-14