dojox.date

Status: Draft
Version: 1.0
Project owner:Tomer Mahlin
Contributors:Helena Halperin, Moshe Wajnberg
Available:since V1.4

Implements the traditional Hebrew calendar. This is the civil calendar in Israel and the liturgical calendar of the Jewish faith worldwide.

Introduction

The Hebrew calendar is lunisolar and thus has a number of interesting properties that distinguish it from the Gregorian. Months start on the day of (an arithmetic approximation of) each new moon. Since the solar year (approximately 365.24 days) is not an even multiple of the lunar month (approximately 29.53 days) an extra "leap month" is inserted in 7 out of every 19 years. To make matters even more interesting, the start of a year can be delayed by up to three days in order to prevent certain holidays from falling on the Sabbath and to prevent certain illegal year lengths. Finally, the lengths of certain months can vary depending on the number of days in the year.

Usage

Code snippet below illustrates most common usage of Hebrew calenadar.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 <script type="text/javascript">
   dojo.require("dojox.date.hebrew");
   dojo.require("dojox.date.hebrew.Date");
   dojo.require("dojox.date.hebrew.locale");
 </script>
 <html><title> Hebrew calendar </title><body>
   <input id="hebcal"
      name="noDOMvalue"
      value="2009-03-10"
      type="text"
      dojoType="dijit.form.DateTextBox"
      datePackage = "dojox.date.hebrew"
      lang="en"
      constraints="{min:'2008-03-01',max:'2009-04-01',datePattern:'dd MMMM yyyy'}"
   >
 </body></html>

Hebrew calendar package

Hebrew calenadar package comprises of following three files:

  • dojox.date.hebrew.Date implements logic of Hebrew calendar and provides support for date conversion between Gregorian and Hebrew calendars
  • dojox.date.hebrew.locale includes implementation of functions responsible for conversion between two possible representations of Hebrew date: String representation and Date object. It also provides date formatting capabilities.
  • dojox.date.hebrew.numerals - provides support for Hebrew numerals.

Hebrew calendar and DateTextBox

Hebrew calendar implemented in this package can be used in conjunction with DateTextBox in order to provide graphical date picker for Hebrew calendar. For example, image below illustrates DateTextBox using Hebrew calendar with default language set to Hebrew.

Examples

Programmatic example

The code snippet below illustrates conversion between two possible representations of Hebrew date: String and Date object.

 <script type="text/javascript">
  var options = {datePattern:'EEEE dd MMMM yyyy HH:mm:ss', selector:'date'};
  // converts string representation of Hebrew date to Date object
  var dateHeb = dojox.date.hebrew.locale.parse("י"ד אדר שני תשס"ט", options);
  // formats Hebrew date object and serialize it into a string
  var dateHebString = dojox.date.hebrew.locale.format(dateHeb,options);
 </script>

Declarative example

Code snippet below illustrates usage of Hebrew calendar in the context of graphical date picker - DateTextBox

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 <script type="text/javascript">
   dojo.require("dojox.date.hebrew");
   dojo.require("dojox.date.hebrew.Date");
   dojo.require("dojox.date.hebrew.locale");
 </script>
 <html><title> Hebrew calendar </title><body>
   <input id="hebcal"
      name="noDOMvalue"
      value="2009-03-10"
      type="text"
      dojoType="dijit.form.DateTextBox"
      datePackage = "dojox.date.hebrew"
      lang="en"
      constraints="{min:'2008-03-01',max:'2009-04-01',datePattern:'dd MMMM yyyy'}"
   >
 </body></html>

See also

  • "Calendrical Calculations", by Nachum Dershowitz & Edward Reingold, Cambridge University Press, 1997, pages 85-91.

  • Hebrew Calendar Science and Myths, http://www.geocities.com/Athens/1584/

  • The Calendar FAQ, http://www.faqs.org/faqs/calendars/faq/

  • General overview of Hebrew numerals
    • http://en.wikipedia.org/wiki/Hebrew_numerals
    • http://www.i18nguy.com/unicode/hebrew-numbers.html
    • http://smontagu.org/writings/HebrewNumbers.html

dojox/date/hebrew (last edited 2009-08-10 12:32:11 by peller)