新規作成 | 一覧 | RSS | FrontPage | 検索 | 更新履歴
[Calendar/When/Ruby] (前:Event_FAQ|次:1.実行環境) (English)

Ruby

When.exe: A multicultural and multilingualized calendar library

概要

本ライブラリは古今東西あらゆる文化および言語で用いられた暦を表現し変換することを目指している Ruby 用のライブラリです。

Rubyのダウンロード http://www.ruby-lang.org/ja/downloads/
本ライブラリを用いたWebサーバの実装例 http://hosi.org
本ライブラリを用いた日本暦注検索画面 http://hosi.org/Note
本ライブラリアーカイヴ一式 http://www.asahi-net.or.jp/~dd6t-sg/date/when_exe_rev.0.5.0beta.zip
リソース辞書 http://www2u.biglobe.ne.jp/~suchowan/ResourceDictionary.html
yardで作ったAPI仕様 http://hosi.org/frames または http://www2u.biglobe.ne.jp/~suchowan/when_exe/frames.html
GitHub https://github.com/suchowan/when_exe
RubyGems http://rubygems.org/gems/when_exe
最近の進展情報 https://suchowan.seesaa.net/tag/when.exe

目的・用途

基本的な目的は、古今東西あらゆる文化および言語で用いられた暦日・暦法・時法・暦年代・暦注などに ユニークな名前付けを行い、統一的に扱うための枠組みを提供することです。

またTZInfogoogle-apis-calendar_v3 と協働する点も特徴になるのではないでしょうか。

結果としてWebサーバーのエンジンなどに向くライブラリにはなったと思います。

Ruby にもともとついてくる Time, Date, DateTimeなどのクラスにくらべて桁違いに動作速度が遅く、 これらを置き換えるものではありません。

現状のステータス

2021-05-06時点では、本ライブラリはβ版でrev.0.5.0です。

著作権表示

Copyright (C) 2011-2021 Takashi SUGA

You may use and/or modify this library according to the MIT license described in the LICENSE.txt file.

You should use datasets TemporalPositionDataSet and TemporalReferenceSystemDataSet according to CC-BY license.

You should use datasets described in /test/events according to each datasets' {dcq:license} link.

目次

Ruby
  1.実行環境
    1.環境準備
    2.irb
    3.when.rb
    4.railsデモ
  2.APIの使用例
    1.前提となる概念
    2.逆引き
    3.年号の扱い
    4.時間間隔
    5.剰余類
    6.iCalendar
    7.暦注
    8.多言語対応文字列
    9.標準クラスとの変換
    A.初期設定
  3.クラス図
    01.Coordinates
    02.BasicTypes
    03.CalendarTypes
    04.Ephemeris
    05.RFC5545継承と包含
    06.時間スキーマの構造
    07.時間オブジェクト
    08.時間幾何プリミティブ
    09.RelativePosition
    10.Duration
    11.時間の位相
    12.時間参照系
    13.暦及び時計
    14.時間座標系
    15.順序時間参照系
    16.時間位置のためのデータ型

時間スキーマ

ISO 19108 (JIS X 7108) の時間スキーマは、日付や時刻などの Temporal Position (より一般には、それらから構成される Temporal Objects) が、暦法や時法などの Temporal Reference System を参照する構造になっています。

本ライブラリは、Temporal Position などを When.exe Standard Representation (「1.日付時刻の表現」参照)で名前付け、 Temporal Reference System を International Resource Identifier (「2.国際化リソース識別子」参照) で名前付けして管理するという仕組みにしています。

本ライブラリを使用した Ruby on Rails デモプログラム http://hosi.org:3000インド太陰太陽暦のある日を表示してみましょう。

画面の最上部に、その日付のユリウス通日 2456952 に続けて、When.exe Standard Representation と International Resource Identifier を組み合わせた表現が表示されます。

 Date[2456952]: 1936-07<13-^^HinduLuniSolar?note=HinduNote&location=(_co:Indian::Ujjain)&start_month=5&type=SBSA

表現は“^^”で2つの部分に分かれます。前半が When.exe Standard Representation、後半が International Resource Identifier の http://hosi.org/When/CalendarTypes/ (プレフィクス“_c:”)に続く部分です。

“1936-07<13-”は1936年7月黒分13日、“HinduLuniSolar?..”はBija補正ありのスールヤ・シッダーンタ方式でウッジャイン(http://hosi.org/When/Coordinates/Indian::Ujjain)の経緯度を基準にして計算した、年がチャイトラ月始まりのサカ紀元、月が新月終わりのシステムの、暦注としてパンチャンガをも計算するヒンドゥー式太陰太陽暦を意味します。

リソース辞書

本ライブラリで扱う主なリソースの一覧は「リソース辞書」をご覧ください。

前項で例としたリソース“_c:HinduLuniSolar”は (2) Calendar、“_co:Indian::Ujjain”は (9) Spatial に記載しています。

経緯

暦相互変換プログラムwhen.exeは、 1990年頃に開発をはじめてもう四半世紀近くになるMS-DOSコマンドライン型ツールでした。 開発しながら暦の勉強をしてきたため、そのアーキテクチャはつぎはぎだらけで、改造や強化には向きません。 また、内部構造が汚くなっているため、UNIX や MacOS など他のプラットホームに移植したり、 ソースリストを公開して、そのアルゴリズムを社会に還元することもできません。 これまではプログラム自体に手をつけることなく、when.exe を検索ツールのエンジンとして tcl/tk や Web から使用するという方策でしのいできました。 しかし、Windows が XP->Vista->7 と進化するにつれ when.exe の動作環境が次第に失われ、 これらの方策もそろそろ限界にきています。

改版の機会は過去に2回ありました。

(1) C++ による改版

約20年前にプログラムを C++ で作り直そうとしました。C++ を選択したのは、暦は「互いに似ているが ちょっと異なる」というものが多く、オブジェクト指向でアーキテクチャを整理するのに向いているからです。 ところがデータを含めて約1万行近く作成したところで、自分が作っているのが、暦相互変換プログラムそのもの ではなく、その前提となる諸々の「しかけ」であることに気づいたのです。「互いに似ているがちょっと異なる、 今知られているものだけではなく、今後見つかるものも簡単に作れる」というアーキテクチャにするためには、 C++ は「しかけ」が不足でした。

(2) Ruby による改版

約10年前にRubyで作り直そうとしました。前節で気がついた「しかけ」を Ruby の用語で示すと、

などです。Ruby に用語があるということは、これらの機能が Ruby にほぼ備わっているということです。 再度、改版にトライしました。しかし今度は、膨大なバリエーションになる暦の諸々の概念を ユニークに名前付けするという問題が解決しきれず頓挫 してしまいました。

そして今回の再トライです。

(3) 国際規格の取り込み

今回のきっかけは、名前付けを行う前提となる、諸々の国際規格が整ってきたことに気づいたことです。

ISO8601とRFC2445は(2)の時点で認識していたのですが、もっとも重要なJIS X7108がリリースされたのは、 ちょうど(2)が頓挫したころで、当時はその存在に気がつきませんでした。 今回の改版ではこれらの国際規格をベースとして過去及び現在存在するすべての暦を表現するべく改版を行っています。

ただし、本ライブラリの実装は参照した国際規格のそれぞれについて、過不足があります。

(*) 2001年の IETF 50th meeting@Minneapolis に参加して RFC 2445の議論を傍聴した際には 「複雑すぎてちゃんとした実装がない」という話題がありました。RFC 2445→RFC 5545は むしろ簡素化する方向への見直しと思われ、本ライブラリでの拡張が標準にとりいれられることはないでしょう。

(4) 最近の進展

テーマ「when.exe」のブログ記事をご覧ください。