27時間制のAPI|27時間多時間群文明
DOCS · 生活実装
00:00:00

Document#5.1 27時間制のAPI

5.1.-1 時刻取得API

時刻取得APIは、27時間多時間群文明における「現在」を、機械可読かつ人間解釈可能な形式で提供するための基本インターフェースである。 本APIは、文明時計を唯一の正規時間源とし、文明EPOCHからの経過秒数を基底とした時間情報を返却する。

取得可能な情報には、文明日・文明時・文明分・文明秒といった分解表現のほか、内部的な通算秒数(epochSeconds)が含まれる。 これにより、表示用途・記録用途・計算用途のいずれにおいても、単一のAPI呼び出しで整合した時間情報を得ることが可能となる。

また、本APIは「絶対時刻」と「局所表現」を明示的に分離する。絶対時刻は文明全体で共有される基準であり、 局所表現は呼び出し主体(構成員・システム・サービス)が属する時間群や位相設定を反映した補助的な表現として付与される。 これにより、同一の時点を異なる時間感覚で扱うことができる。

5.1.-2 位相・群情報の取得API

位相・群情報取得APIは、構成員またはシステムが自身および他者の時間的位置づけを把握するための文明横断的な参照インターフェースである。 本APIは、単なる「時刻」に留まらず、文明周期上の位相、所属時間群、群間オフセットといった構造化された時間的文脈を返却する。

提供される位相情報は、活動帯・低活動帯・休息帯といった状態的区分を含み、数値的な位相値と併せて表現される。 これにより、アプリケーションやサービスは、相手が「何時か」だけでなく「どの状態にあるか」を前提とした振る舞いを設計できる。

群情報は、固定的な属性ではなく、移群プロトコルに基づく動的な状態として扱われる。 APIは現在の所属群に加え、直近の移群履歴や予定された群移動の有無といった補助情報を返却することが想定されている。 これにより、非同期的な調整や事前合意形成が容易になる。

本APIは、人間向けインターフェースだけでなく、非ヒト知性や自律システムによる調停・補助を前提とした設計である。 位相や群の情報は、判断の自動化ではなく、判断材料の透明な提供を目的とし、構成員の主体的選択を侵害しない形で利用される。