hebcal 0.0.2

data/.gitignore

@@ -0,0 +1,18 @@
+jquery.js
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Isaac Betesh
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,99 @@
+# HebCal
+
+Determines the date of Passover for a Gregorian year. Also includes boolean functions to check whether a date is a Jewish holiday, Fast Day or Rosh Chodesh.
+Supported languages:
+ Javascript
+ Ruby
+
+## Installation as a Ruby gem
+
+Add this line to your application's Gemfile:
+    gem 'hebcal'
+And then execute:
+    $ bundle
+Or install it yourself as:
+    $ gem install hebcal
+
+## General notes
+
+1. 3- and 4-digit years are supported, so the domain of valid years is 100-9999.  For years before the Gregorian transition (1582), the transition is ignored and the proleptic Gregorian calendar is used.
+
+## Ruby Version
+
+### To Run Unit Tests
+    $ rake test
+
+### To Use
+
+#### Calculating the date of Passover
+1. At the top of the file where the class is defined, declare `require `hebcal``
+
+1. In the class, declare `include HebCal::Passover`
+
+1. `WhenIsPesach(yyyy)` returns a Ruby Time object representing midnight on the first day of passover, where `yyyy` is the Gregorian year
+
+    Note that the date returned is the first day of Pesach, not the day on which Pesach begins at sunset.
+
+#### Finding out if a date is a holiday
+1. At the top of the file where the class is defined, declare `require `hebcal``
+
+1. In the desired class, declare `include HebCal::Holidays`
+
+1. `IsPesach(d)` returns true iff d is a Ruby Time object representing a date during Pesach.  Note that the day on which Pesach begins at sunset returns false.
+1. The following functions work in a similar way to `IsPesach()`:
+ 1. `IsShavuot()`, `IsRoshHashanah()`, `IsYomKippur()`, `IsSukkot()`
+
+ 1. `IsRegel()`: `IsPesach() || IsShavuot || IsSukkot()`
+
+ 1. `IsMoed()`: Hol HaMoed Pesach or Hol HaMoed Sukkot
+
+ 1. `IsYomTov()`: `IsPesach() || IsShavuot() || IsRoshHashanah() || IsSukkot()) && !IsMoed()`
+
+     Note that IsYomTov(yk) == false, where yk is the date of Yom Kippur.
+
+ 1. `IsPurim()`, `IsHanuka()`
+
+ 1. `Is10Tevet()`, `IsTaanitEster()`, `Is17Tamuz()`, `Is9Av()`, `IsFastOfGedalia()`
+
+ 1. `IsTaanit()`: `Is10Tevet() || IsTaanitEster() || Is17Tamuz() || Is9Av() || IsFastOfGedalia()`
+
+ 1. `IsRoshChodesh()`
+
+## Javascript Version
+
+### To Run Unit Tests
+1. Open index.html in a browser.  You should see a lot of green text saying that tests passed.  If not, javascript may not be enabled in your browser.  Scroll down to the bottom and verify that the summary says all tests passed.
+
+### To Use
+1. Include the javascript source file in your HTML page
+
+ 1. If using Ruby On Rails, you can declare `//= require hebcal` at the top of a javascript or coffeescript file
+ 1. To include the script explicitly in an html file, 
+
+     `<script src="app/assets/javascripts/hebcal/passover.js" type="text/javascript"></script>`
+
+1. All date formats are YYYY-mm-dd, where month is index from 1 (i.e. 1 == January, not the usual javascript index of 0 == January!) and YYYY is the Gregorian year.
+
+1. $.whenIsPesach(yyyy) returns a date in the above format, where yyyy is the Gregorian year.
+
+    Note that the date returned is the first day of Pesach, not the day on which Pesach begins at sunset.
+1. $.isPesach(d) returns true iff d is a date during Pesach, in the above format.  Note that the day on which Pesach begins at sunset returns false.
+1. The following functions work in a similar way to $.isPesach():
+ 1. $.isShavuot(), $.isRoshHashanah(), $.isYomKippur(), $.isSukkot();
+
+ 1. $.isRegel(): $.isPesach() || $.isShavuot() || $.isSukkot();
+
+ 1. $.isMoed(): Hol HaMoed Pesach or Hol HaMoed Sukkot;
+
+ 1. $.isYomTov(): ($.isPesach() || $.isSukkot() || $.isShavuot() || $.isRoshHashanah()) && !$.isMoed();
+
+     Note that isYomTov(yk) == false, where yk is the date of Yom Kippur.
+
+ 1. `$.isPurim()`, `$.isHanuka()`
+
+ 1. `$.isRoshChodesh()`
+
+ 1. `$.is10Tevet()`, `$.isTaanitEster()`, `$.is17Tamuz()`, `$.is9Av()`, `$.isFastOfGedalia()`
+
+ 1. `$.isTaanit()`: `$.is10Tevet() || $.isTaanitEster() || $.is17Tamuz() || $.is9Av() || $.isFastOfGedalia()`
+

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec
+

data/app/assets/javascripts/hebcal/index.js

@@ -0,0 +1 @@
+//= require ./passover

data/app/assets/javascripts/hebcal/passover.js

@@ -0,0 +1,253 @@
+(function($) {
+
+  var SHAVUOT_DISTANCE = 50;
+  var SUKKOT_DISTANCE = 59 * 3;
+  var PURIM_DISTANCE = -30;
+  var STANDARD_HANUKAH_DISTANCE = 59 * 4 + 10;
+  var FAST_AB_DISTANCE = 59 * 2 - 6;
+  var STANDARD_10_TEVET_DISTANCE = 59 * 4 + 30 - 5;
+
+  function is_leap_year(year) {
+    return (-1 != [3,6,8,11,14,17,19].indexOf(year % 19));
+  }
+
+  function precedes_leap_year(year) {
+    return is_leap_year(year+1);
+  }
+
+  function leadingZero(n) {
+    return n <= 9 ? "0" + n : n;
+  }
+
+  function formatDate(date) {
+    return date.getFullYear() + "-" + leadingZero(date.getMonth()+1) + "-" + leadingZero(date.getDate());
+  }
+
+  function calculate_pesach(yearG) {
+
+    // CONSTANTS
+    var HALAKIM_PER_HOUR = 1080;
+    var HALAKIM_PER_DAY = 24 * HALAKIM_PER_HOUR;
+    var ANNUAL_DRIFT = 10 * HALAKIM_PER_DAY + 21 * HALAKIM_PER_HOUR + 204;
+    var JULIAN_ANNUAL_CALENDAR_DRIFT = HALAKIM_PER_HOUR * 6;
+    var JULIAN_YEAR = 365.25 * HALAKIM_PER_DAY;
+
+    var LUNAR_CYCLE = 29 * HALAKIM_PER_DAY + 12 * HALAKIM_PER_HOUR + 793;
+    var HALAKIM_PER_19_YEAR_CYCLE = 235 * LUNAR_CYCLE;
+
+    var JULIAN_ERROR_PER_19_YEAR_CYCLE = JULIAN_YEAR * 19 - HALAKIM_PER_19_YEAR_CYCLE;
+    var EPOCH_TEKUFAH = -(20 * HALAKIM_PER_HOUR + 302);
+
+    var MOLAD_ZAQEN = 6 * HALAKIM_PER_HOUR;
+    var TUTAKPAT = 15 * HALAKIM_PER_HOUR + 589;
+    var TARAD = 9 * HALAKIM_PER_HOUR + 204;
+
+    // CALCULATE MOLAD
+    var yearH = yearG + 3760;
+    var drift_since_epoch = (LUNAR_CYCLE + EPOCH_TEKUFAH + (LUNAR_CYCLE - ANNUAL_DRIFT) * (yearH % 19) - HALAKIM_PER_DAY) % LUNAR_CYCLE;
+    var year_in_julian_cycle = yearG % 4;
+    var molad = LUNAR_CYCLE + HALAKIM_PER_DAY + MOLAD_ZAQEN + drift_since_epoch + (year_in_julian_cycle * JULIAN_ANNUAL_CALENDAR_DRIFT) - (JULIAN_ERROR_PER_19_YEAR_CYCLE * Math.floor(yearH / 19));
+    var halakim_into_day = molad % HALAKIM_PER_DAY;
+
+    // CALCULATE CALENDAR DATE OF PESACH
+    var gregorian_divergence = Math.floor(yearG/100) - Math.floor(yearG/400) - 2;
+    var pesach_julian_day = (molad - halakim_into_day) / HALAKIM_PER_DAY 
+
+    var day_of_week = ((3 * yearG) + (5 * year_in_julian_cycle) + pesach_julian_day) % 7;
+    var pesach_day = pesach_julian_day + gregorian_divergence;
+
+    if (-1 != [1,3,5].indexOf(day_of_week)) {
+      pesach_day += 1;
+    } else if (0 == day_of_week && !precedes_leap_year(yearH) && halakim_into_day >= TARAD + MOLAD_ZAQEN) {
+      pesach_day += 2;
+    } else if (6 == day_of_week && is_leap_year(yearH) && halakim_into_day >= TUTAKPAT + MOLAD_ZAQEN) {
+      pesach_day += 1;
+    }
+    var pesach_month = 2;
+
+    return new Date(yearG, pesach_month, pesach_day);
+  }
+  
+  $.whenIsPesach = function(yearG) {
+    return formatDate(calculate_pesach(yearG));
+  };
+
+  function parse_date(date) {
+    date = /([0-9]{3,5})-([0-9]{2})-([0-9]{2})/.exec(date);
+    return new Date(date[1], date[2] - 1, date[3]);
+  }
+
+  function get_distance(date1, date2) {
+      hours = (date2 - date1) / 60 / 60 / 1000;
+      if (-1 != [1, -23].indexOf(hours % 24)) {
+        hours -= 1;
+      } else if (-1 != [-1, 23].indexOf(hours % 24)) {
+        hours += 1;
+      }
+      return hours / 24;
+  }
+
+  function pesach_distance(date) {
+    date = parse_date(date);
+    var pesach = calculate_pesach(date.getFullYear());
+    return get_distance(pesach, date);
+  }
+
+  function is_distance_in_range(distance, begin, length) {
+    return distance >= begin && distance <= begin + length - 1;
+  }
+
+  function get_pesach_and_year_length(date) {
+    var year = date.getFullYear();
+    var pesach1 = calculate_pesach(year);
+    var pesach2;
+    if (get_distance(pesach1, date) < -59) {
+      pesach2 = pesach1;
+      pesach1 = calculate_pesach(year - 1);
+    } else {
+      pesach2 = calculate_pesach(year + 1);
+    }
+    var result = {};
+    result.pesach = pesach1;
+    result.length = get_distance(pesach1, pesach2);
+    return result;
+  }
+
+  $.isPesach = function(date) {
+    return is_distance_in_range(pesach_distance(date), 0, 8);
+  };
+
+  $.isShavuot = function(date) {
+    return is_distance_in_range(pesach_distance(date), SHAVUOT_DISTANCE, 2);
+  };
+
+  $.isRoshHashanah = $.isRoshHaShanah = function(date) {
+    return is_distance_in_range(pesach_distance(date), SUKKOT_DISTANCE - 14, 2);
+  };
+
+  $.isYomKippur = function(date) {
+    return is_distance_in_range(pesach_distance(date), SUKKOT_DISTANCE - 5, 1);
+  };
+
+  $.isSukkot = function(date) {
+    return is_distance_in_range(pesach_distance(date), SUKKOT_DISTANCE, 9);
+  };
+
+  $.isMoed = function(date) {
+    var distance = pesach_distance(date);
+    return is_distance_in_range(distance, 2, 4) || is_distance_in_range(distance, SUKKOT_DISTANCE + 2, 5);
+  };
+
+  $.isRegel = function(date) {
+    var distance = pesach_distance(date);
+    return is_distance_in_range(distance, 0, 8) || is_distance_in_range(distance, SHAVUOT_DISTANCE, 2) || is_distance_in_range(distance, SUKKOT_DISTANCE, 9);
+  };
+
+  $.isYomTov = function(date) {
+    // Note that Yom Kippur is not a Yom Tov
+    var distance = pesach_distance(date);
+    return is_distance_in_range(distance, 0, 2) || is_distance_in_range(distance, 6, 2) || is_distance_in_range(distance, SHAVUOT_DISTANCE, 2) || is_distance_in_range(distance, SUKKOT_DISTANCE - 14, 2) || is_distance_in_range(distance, SUKKOT_DISTANCE, 2) || is_distance_in_range(distance, SUKKOT_DISTANCE + 7, 2);
+  };
+
+  $.isPurim = function(date) {
+    return is_distance_in_range(pesach_distance(date), PURIM_DISTANCE, 1);
+  }
+
+  $.isHanuka = $.isHanukka = $.isHanukah = $.isHanukkah = $.isChanuka = $.isChanukka = $.isChanukah = $.isChanukkah = function(date) {
+    date = parse_date(date);
+    var data = get_pesach_and_year_length(date);
+    var distance = STANDARD_HANUKAH_DISTANCE;
+    if (-1 != [355, 385].indexOf(data.length)) {
+      distance = distance + 1;
+    }
+    return is_distance_in_range(get_distance(data.pesach, date), distance, 8);
+  }
+
+  $.isRoshChodesh = $.isRoshHodesh = function(date) {
+    date = parse_date(date);
+    var result = get_pesach_and_year_length(date);
+    var distance = get_distance(result.pesach, date);
+    var length = result.length;
+    var distances             =  [   -59 + 15,    -59 + 16,    -59 + 30 + 15];
+    distances = distances.concat([         15,          16,          30 + 15]);
+    distances = distances.concat([    59 + 15,     59 + 16,     59 + 30 + 15]);
+    distances = distances.concat([2 * 59 + 15, 2 * 59 + 16]);
+    distances = distances.concat([3 * 59 + 15, 3 * 59 + 16, 3 * 59 + 30 + 15]);
+    if (-1 != [353, 383].indexOf(length)) {
+      distances = distances.concat([4 * 59 + 15]);
+      distances = distances.concat([4 * 59 + 30 + 14]);
+      if (383 == length) {
+        distances = distances.concat([5 * 59 + 14, 5 * 59 + 15]);
+      }
+    } else if (-1 != [354, 384].indexOf(length)) {
+      distances = distances.concat([4 * 59 + 15, 4 * 59 + 16]);
+      distances = distances.concat([4 * 59 + 30 + 15]);
+      if (384 == length) {
+        distances = distances.concat([5 * 59 + 15, 5 * 59 + 16]);
+      }
+    } else if (-1 != [355, 385].indexOf(length)) {
+      distances = distances.concat([3 * 59 + 30 + 16]);
+      distances = distances.concat([4 * 59 + 16, 4 * 59 + 17]);
+      distances = distances.concat([4 * 59 + 30 + 16]);
+      if (385 == length) {
+        distances = distances.concat([5 * 59 + 16, 5 * 59 + 17]);
+      }
+    }
+    return (-1 != distances.indexOf(distance));
+  }
+
+  function is_fast_with_sunday_postponement(date, distance) {
+    var dow = parse_date(date).getDay();
+    var pesach_dist = pesach_distance(date);
+    return (6 != dow && is_distance_in_range(pesach_dist, distance, 1)) || (0 == dow && is_distance_in_range(pesach_dist, distance + 1, 1));
+  }
+
+  $.is9Ab = $.is9Av = function(date) {
+    return is_fast_with_sunday_postponement(date, FAST_AB_DISTANCE);
+  }
+
+  $.is17Tamuz = $.is17Tammuz = function(date) {
+    return is_fast_with_sunday_postponement(date, FAST_AB_DISTANCE - 21);
+  }
+
+  $.isTzomGedalia = $.isTzomGedaliah = $.isFastOfGedalia = $.isFastOfGedaliah = function(date) {
+    return is_fast_with_sunday_postponement(date, SUKKOT_DISTANCE - 12);
+  }
+
+  $.isTaanitEsther = $.isTaanitEster = function(date) {
+    var dow = parse_date(date).getDay();
+    return (6 != dow && is_distance_in_range(pesach_distance(date), PURIM_DISTANCE - 1, 1)) || (4 == dow && is_distance_in_range(pesach_distance(date), PURIM_DISTANCE - 3, 1));
+  }
+
+  $.is10Tevet = function(date) {
+    date = parse_date(date);
+    var data = get_pesach_and_year_length(date);
+    var distance = STANDARD_10_TEVET_DISTANCE
+    if (-1 != [353, 383].indexOf(data.length)) {
+      distance = distance - 1;
+    }
+    if (-1 != [355, 385].indexOf(data.length)) {
+      distance = distance + 1;
+    }
+    return is_distance_in_range(get_distance(data.pesach, date), distance, 1);
+  }
+
+  $.isTaanit = function(date) {
+    var dow = parse_date(date).getDay();
+    if (6 == dow) {
+      return false;
+    }
+    var distance = pesach_distance(date);
+    if (is_distance_in_range(distance, FAST_AB_DISTANCE, 1) || is_distance_in_range(distance, FAST_AB_DISTANCE - 21, 1) || is_distance_in_range(distance, SUKKOT_DISTANCE - 12, 1) || is_distance_in_range(distance, PURIM_DISTANCE - 1, 1)) {
+      return true;
+    }
+    if (0 == dow && (is_distance_in_range(distance, FAST_AB_DISTANCE + 1, 1) || is_distance_in_range(distance, FAST_AB_DISTANCE - 21 + 1, 1) || is_distance_in_range(distance, SUKKOT_DISTANCE - 12 + 1, 1))) {
+      return true;
+    }
+    if (4 == dow && is_distance_in_range(distance, PURIM_DISTANCE - 3, 1)) {
+      return true;
+    }
+    return $.is10Tevet(date);
+  }
+
+})($);

data/hebcal.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/hebcal/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Isaac Betesh"]
+  gem.email         = ["iybetesh@gmail.com"]
+  gem.description   = `cat README.md`
+  gem.summary       = 'Determines the date of Passover for a Gregorian year. Determines whether a Gregorian date is a Jewish holiday.'
+  gem.homepage      = "https://github.com/betesh/hebcal"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "hebcal"
+  gem.require_paths = ["lib"]
+  gem.version       = HebCal::VERSION
+  gem.license       = 'MIT'
+end

data/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Aliyot</title>
+  <script src="test/test.js" type="text/javascript"></script>
+  <script src="app/assets/javascripts/hebcal/passover.js" type="text/javascript"></script>
+</head>
+<body onload="RunTest()">
+<div id="test_results">
+</div>
+</body>
+</html>