when_exe - A multicultural and multilingualized calendar library
when_exe is a multicultural and multilingualized calendar library based on ISO 8601, ISO 19108, RFC 5545(iCalendar) and RFC6350. JSON-LD format for TemporalPosition and TemporalReferenceSystem are available.
Installation
The when_exe gem can be installed by running:
gem install when_exe
Web Server
Web server for when_exe demonstration is available on hosi.org ( or mirror site hosi-org.herokuapp.com ).
You can see examples of When.exe Standard Representation and Reference System IRI at the top-left corner of Date frame.
Preferences are changeable on hosi.org/cookies.
SPARQL endpoint is hosi.org/japan/sparql.
Documentation
API documentation for when_exe is available on RubyDoc.info or here.
Available calendars and clocks are defined as subclasses of TM_Calendar and TM_Clock or using definition tables in CalendarTypes namespace.
Available calendar eras are defined using definition tables in CalendarEra namespace.
Whole TemporalReferenceSystem resources are listed in the Resource Dictionary.
For further detail, please refer to the when_exe Wiki pages.
License
This beta version's license is limited. Please see LICENSE.txt for details.
Data sets TemporalPositionDataSet and TemporalReferenceSystemDataSet should be used according to CC-BY-ND license.
Source Code
Source code for when_exe is available on GitHub.
Example Usage
require 'when_exe'
# include When
# When::TM::CalDate ---------------------------
gregorian_date = When.tm_pos(2014, 8, 1)
p gregorian_date #=> 2014-08-01
p When.when?('2014-08-01') #=> 2014-08-01, the same date
p gregorian_date.to_i #=> 2456871, Julian Day Number(Integer)
p gregorian_date.to_f #=> 2456871.0, at noon for UTC
p gregorian_date.class #=> When::TM::CalDate
p gregorian_date.frame.iri #=> "http://hosi.org/When/CalendarTypes/Gregorian"
puts gregorian_date.name(When::MONTH).class #=> When::BasicTypes::M17n
puts gregorian_date.name(When::MONTH).iri #=> http://hosi.org/When/BasicTypes/M17n/Calendar::Month::August
puts gregorian_date.name(When::MONTH) / 'en' #=> August
puts gregorian_date.name(When::MONTH) / 'fr' #=> août
puts gregorian_date.name(When::MONTH) / 'ar' #=> اغسطس
p gregorian_date.easter #=> 2014-04-20
p gregorian_date.is?('Easter') #=> false
p When.tm_pos(2014, 4, 20).is?('Easter') #=> true
islamic_date = When::TabularIslamic ^ gregorian_date
p islamic_date #=> 1435-10-04
p When.tm_pos(1435, 10, 4, :frame=>'TabularIslamic')
#=> 1435-10-04, the same date
p When.when?('1435-10-4^TabularIslamic') #=> 1435-10-04, the same date
p islamic_date.frame.iri #=> "http://hosi.org/When/CalendarTypes/TabularIslamic"
puts islamic_date.name(When::MONTH) / 'en' #=> Shawwal
puts islamic_date.name(When::MONTH) / 'ar' #=> شوال
# When::TM::DateAndTime ------------------------
gregorian_date = When.tm_pos(2014, 8, 1, 9, 0, 0, :clock=>'+09:00')
p gregorian_date #=> 2014-08-01T09:00:00+09:00
p When.when?('2014-08-01T09:00:00+09:00') #=> 2014-08-01T09:00:00+09:00, the same date
p gregorian_date.to_i #=> 2456871, Julian Day Number(Integer)
p gregorian_date.to_f #=> 2456870.5 at 09:00:00 of Timezone +09:00
p gregorian_date.class #=> When::TM::DateAndTime
p gregorian_date.frame.iri #=> "http://hosi.org/When/CalendarTypes/Gregorian"
p gregorian_date.clk_time.class #=> When::TM::ClockTime
p gregorian_date.clk_time.frame.iri #=> "http://hosi.org/When/TM/Clock?label=+09:00"
gregorian_date = When.tm_pos(2014, 8, 1, 9, 0, 0, :clock=>'+09:00',
:long=>'139.413012E', :lat=>'35.412222N')
p gregorian_date #=> 2014-08-01T09:00:00+09:00
p gregorian_date.location.iri #=> "http://hosi.org/When/Coordinates/Spatial?long=139.413012E&lat=35.412222N&alt=0"
p gregorian_date.sunrise.floor(When::MINUTE) #=> 2014-08-01T04:48+09:00
p gregorian_date.sunset.floor(When::MINUTE) #=> 2014-08-01T18:46+09:00
darian_date = When::Darian ^ gregorian_date
p darian_date #=> 0216-13-23T15:12:11MTC
p darian_date.to_i #=> 49974, Serial Day Number(Integer)
p darian_date.to_f #=> 49974.13346485421
p darian_date.frame.iri #=> "http://hosi.org/When/CalendarTypes/Darian"
p darian_date.clk_time.frame.iri #=> "http://hosi.org/When/CalendarTypes/MTC"
p darian_date.time_standard.iri #=> "http://hosi.org/When/TimeStandard/MartianTimeCoordinated?location=(_l:long=0&datum=Mars)"
# When::TM::CalendarEra ------------------------
babylonian_date = When.tm_pos('NebuchadnezzarII', 1, 1, 1)
p babylonian_date #=> NebuchadnezzarII01(-603).01.01
p When.when?('NebuchadnezzarII1.1.1') #=> NebuchadnezzarII01(-603).01.01, the same date
p babylonian_date.to_i #=> 1500904, Julian Day Number(Integer)
p When.era('NebuchadnezzarII') #=> [_e:AncientOrient::Neo-Babylonian::NebuchadnezzarII]
p When.era('NebuchadnezzarII')[0] ^ 1500904 #=> NebuchadnezzarII01(-603).01.01, the same date
p babylonian_date.to_f #=> 1500904.0, at noon for UTC
p babylonian_date.frame.iri #=> "http://hosi.org/When/CalendarTypes/BabylonianPD"
p babylonian_date.calendar_era.iri #=> "http://hosi.org/When/TM/CalendarEra/AncientOrient::Neo-Babylonian::NebuchadnezzarII"
babylonian_date = When.when?('NebuchadnezzarII1.1.1T18:13:00',
:clock=>'+03:00?long=45&lat=32&border=Sunset')
4.times do
p [babylonian_date, babylonian_date.to_i] #=>
# [NebuchadnezzarII01(-603).01.01T:18:13:00+03:00, 1500904]
# [NebuchadnezzarII01(-603).01.01T:18:14:00+03:00, 1500904]
# [NebuchadnezzarII01(-603).01.02T*18:15:00+03:00, 1500905]
# [NebuchadnezzarII01(-603).01.02T*18:16:00+03:00, 1500905]
babylonian_date += When::PT1M
end
# Web service ----------------------------------
# retrieve JSON, JSON-LD, Turtle response from http://hosi.org:3000 (when_exe demonstration web server)
# (Notation3, RDF/XML, N-Triples and XML formats are also available.)
require 'open-uri'
open('http://hosi.org:3000/Date/2014-04-20.json') do |json|
puts json.read #=> newlines and blanks are inserted for readability.
# {"frame" : "http://hosi.org/When/CalendarTypes/Gregorian",
# "precision": 0,
# "location" : "http://hosi.org/When/Coordinates/Spatial?long=139.4441E&lat=35.3916N&alt=0.0",
# "sdn" : 2456768,
# "calendar" : ["http://hosi.org/When/CalendarTypes/Gregorian"],
# "notes" : [[{"note":"Month","value":"April"}],
# [{"note":"Week","value":"Sunday(6)"}]],
# "clock" : "Asia/Tokyo+09:00",
# "clk_time" : [2456768,0,0,0],
# "dynamical": 1397919667.184082,
# "universal": 1397919600.0,
# "cal_date" : [2014,4,20]}
end
open('http://hosi.org/tp/2014-04-20.json') do |json| # redirected from http://hosi.org to http://hosi.org:3000
puts json.read #=> newlines and blanks are inserted for readability.
# {"frame" : "http://hosi.org/When/CalendarTypes/Gregorian",
# "precision": 0,
# "sdn" : 2456768,
# "calendar" : ["http://hosi.org/When/CalendarTypes/Gregorian"],
# "notes" : [[{"note":"Month","value":"April"}],
# [{"note":"Week","value":"Sunday(6)"}]],
# "cal_date" : [2014,4,20]}
end
open('http://hosi.org/tp/2014-04-20.jsonld') do |jsonld| # redirected from http://hosi.org to http://hosi.org:3000
puts jsonld.read #=> newlines and blanks are inserted for readability.
# {"@context":
# {"xsd" :"http://www.w3.org/2001/XMLSchema",
# "rdf" :"http://www.w3.org/1999/02/22-rdf-syntax-ns#",
# "rdfs":"http://www.w3.org/2000/01/rdf-schema#",
# "owl" :"http://www.w3.org/2002/07/owl#",
# "dc" :"http://purl.org/dc/elements/1.1/",
# "dcq" :"http://purl.org/dc/terms/",
# "dct" :"http://purl.org/dc/dcmitype/",
# "ts" :"http://hosi.org/ts#",
# "Week":"http://hosi.org/When/Coordinates/Common::Week::",
# "day" :"http://hosi.org/When/CalendarNote/Christian/Notes::day::"},
# "@graph":[{
# "rdf:type" : {"@id":"http://hosi.org/ts/When/TM/CalDate"},
# "@id" : "http://hosi.org/tp/2014-04-20",
# "ts:sdn" : 2456768,
# "ts:frame" : {"@id":"http://hosi.org/When/CalendarTypes/Gregorian"},
# "ts:coordinate": "20",
# "@reverse" : {"rdfs:member":{"@id":"http://hosi.org/tp/2014-04"}},
# "day:Week" : {"@id":"Week:Sunday"},
# "day:Easter" : "easter(0)",
# "day:Christmas": "christmas(-249)"
# }]
# }
end
open('http://hosi.org/tp/2014-04-20.ttl') do |ttl| # redirected from http://hosi.org to http://hosi.org:3000
puts ttl.read
# @prefix Week: <http://hosi.org/When/Coordinates/Common::Week::> .
# @prefix day: <http://hosi.org/When/CalendarNote/Christian/Notes::day::> .
# @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
# @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
# @prefix ts: <http://hosi.org/ts#> .
# @prefix xsd: <http://www.w3.org/2001/XMLSchema> .
#
# <http://hosi.org/tp/2014-04> rdfs:member <http://hosi.org/tp/2014-04-20> .
#
# <http://hosi.org/tp/2014-04-20> a <http://hosi.org/ts/When/TM/CalDate>;
# day:Christmas "christmas(-249)";
# day:Easter "easter(0)";
# day:Week Week:Sunday;
# ts:coordinate "20";
# ts:frame <http://hosi.org/When/CalendarTypes/Gregorian>;
# ts:sdn 2456768 .
end
open('http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge.ttl') do |ttl| # redirected from http://hosi.org to http://hosi.org:3000
puts ttl.read
# @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
# @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
# @prefix ts: <http://hosi.org/ts#> .
# @prefix xsd: <http://www.w3.org/2001/XMLSchema> .
#
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge> a <http://hosi.org/ts/When/TM/OrdinalReferenceSystem>;
# rdfs:member <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::冥王代>,
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::始生代>,
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代>,
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::顕生代> .
#
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::冥王代> a <http://hosi.org/ts/When/TM/OrdinalEra>;
# ts:begin "-4600000000";
# ts:end "-4000000000";
# ts:label <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::冥王代::冥王代> .
#
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代> a <http://hosi.org/ts/When/TM/OrdinalEra>;
# ts:begin "-2500000000";
# ts:end "-542000000";
# ts:label <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代::原生代>;
# rdfs:member <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代::前期>,
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代::中期>,
# <http://hosi.org/When/TM/OrdinalReferenceSystem/GeologicalAge::原生代::後期> .
# <..snip..>
end
#
# SPARQL endpoint ------------------------------
# https://rubygems.org/gems/sparql is required for this section's operations.
# Please install sparql before operation.
require 'sparql'
PREFIXES = When::Parts::Resource.namespace_prefixes(
'_co:Common', '_co:Common?V=0618', '_m:Calendar', '_m:Japanese', '_n:Japanese/Notes')
client = SPARQL::Client.new("http://hosi.org/japan/sparql")
client.query(PREFIXES.keys.map {|key|
"PREFIX #{key}: <#{PREFIXES[key].last}> "}.join("\n") +
%(
SELECT DISTINCT ?s
WHERE {
?s ts:coordinate "10" .
?s DayNote:廿四節気 SolarTerm:清明 .
?s DayNote:干支 Stem-Branch:壬戌 .
}
)).each do |solution|
p solution[:s].to_s #=>
#=> "http://hosi.org/tp/0689-03-10%5E%5EJapanese"
#=> "http://hosi.org/tp/1490-03-10%5E%5EJapanese"
end
#
# TZInfo ---------------------------------------
# https://rubygems.org/gems/tzinfo is required for this section's operations.
# Please install tzinfo before operation.
gregorian_date = When.tm_pos(2014, 8, 1, 9, 0, 0, :tz=>'Asia/Tokyo')
p gregorian_date #=> 2014-08-01T09:00:00+09:00
p gregorian_date.location.iri #=> "http://hosi.org/When/Coordinates/Spatial?long=139.4441E&lat=35.3916N&label=Asia/Tokyo"
p gregorian_date.sunrise.floor(When::MINUTE) #=> 2014-08-01T04:48+09:00
p gregorian_date.sunset.floor(When::MINUTE) #=> 2014-08-01T18:45+09:00
jst = When.tm_pos(1997, 4, 6, 15, 30, 00, :tz=>'Asia/Tokyo')
p jst #=> 1997-04-06T15:30:00+09:00
est = When.Clock('America/New_York') ^ jst
p est #=> 1997-04-06T01:30:00-05:00
jst = When.tm_pos(1997, 4, 6, 16, 30, 00, :tz=>'Asia/Tokyo')
p jst #=> 1997-04-06T16:30:00+09:00
edt = When.Clock('America/New_York') ^ jst
p edt #=> 1997-04-06T03:30:00-04:00
p When.when?('TZID=America/New_York:1997-10-26T01:30') #=> 1997-10-26T01:30-04:00
p When.when?('TZID=America/New_York:1997-10-26T01=30') #=> 1997-10-26T01:30-05:00, '=' indicates "leap hour"
p When.when?('TZID=America/New_York:1997-10-26T02:30') #=> 1997-10-26T02:30-05:00
p When.when?('TZID=America/New_York:1997-10-26T03:30') #=> 1997-10-26T03:30-05:00
# Google Calendar ------------------------------
# https://github.com/suchowan/gcalapi is required for this section's operations.
# Please install gcalapi before operation.
# Please replace xxxxxxxx and ******** to valid id/password pair and access Google Calendar.
service = GoogleCalendar::Service.new('[email protected]', '********')
feed = "http://www.google.com/calendar/feeds/%s__%s%%40holiday.calendar.google.com/public/full" %
['japanese', 'ja']
gcal = GoogleCalendar::Calendar::new(service, feed)
gcal.enum_for({'start-min'=>'2014-01-01', 'start-max'=>'2015-01-01',
'orderby'=>'starttime', 'sortorder'=>'a'
}).each do |range|
puts '%s - %s' % [range, range.events[0].summary] #=>
# 2014-01-01T00:00:00.00+09:00...2014-01-02T00:00:00.00+09:00 - 元日
# 2014-01-02T00:00:00.00+09:00...2014-01-03T00:00:00.00+09:00 - 銀行休業日
# 2014-01-03T00:00:00.00+09:00...2014-01-04T00:00:00.00+09:00 - 銀行休業日
# 2014-01-13T00:00:00.00+09:00...2014-01-14T00:00:00.00+09:00 - 成人の日
# 2014-02-11T00:00:00.00+09:00...2014-02-12T00:00:00.00+09:00 - 建国記念の日
# 2014-03-21T00:00:00.00+09:00...2014-03-22T00:00:00.00+09:00 - 春分の日
# 2014-04-29T00:00:00.00+09:00...2014-04-30T00:00:00.00+09:00 - 昭和の日
# 2014-05-03T00:00:00.00+09:00...2014-05-04T00:00:00.00+09:00 - 憲法記念日
# 2014-05-04T00:00:00.00+09:00...2014-05-05T00:00:00.00+09:00 - みどりの日
# 2014-05-05T00:00:00.00+09:00...2014-05-06T00:00:00.00+09:00 - こどもの日
# 2014-05-06T00:00:00.00+09:00...2014-05-07T00:00:00.00+09:00 - みどりの日 振替休日
# 2014-07-21T00:00:00.00+09:00...2014-07-22T00:00:00.00+09:00 - 海の日
# 2014-09-15T00:00:00.00+09:00...2014-09-16T00:00:00.00+09:00 - 敬老の日
# 2014-09-23T00:00:00.00+09:00...2014-09-24T00:00:00.00+09:00 - 秋分の日
# 2014-10-13T00:00:00.00+09:00...2014-10-14T00:00:00.00+09:00 - 体育の日
# 2014-11-03T00:00:00.00+09:00...2014-11-04T00:00:00.00+09:00 - 文化の日
# 2014-11-23T00:00:00.00+09:00...2014-11-24T00:00:00.00+09:00 - 勤労感謝の日
# 2014-11-24T00:00:00.00+09:00...2014-11-25T00:00:00.00+09:00 - 勤労感謝の日 振替休日
# 2014-12-23T00:00:00.00+09:00...2014-12-24T00:00:00.00+09:00 - 天皇誕生日
# 2014-12-25T00:00:00.00+09:00...2014-12-26T00:00:00.00+09:00 - クリスマス
# 2014-12-31T00:00:00.00+09:00...2015-01-01T00:00:00.00+09:00 - 大晦日
end