JA:Key:opening_hours

From OpenStreetMap Wiki
Jump to: navigation, search
利用できる言語 — Key:opening hours
· Afrikaans · Alemannisch · aragonés · asturianu · azərbaycanca · Bahasa Indonesia · Bahasa Melayu · Bân-lâm-gú · Basa Jawa · Basa Sunda · Baso Minangkabau · bosanski · brezhoneg · català · čeština · corsu · dansk · Deutsch · eesti · English · español · Esperanto · estremeñu · euskara · français · Frysk · Gaeilge · Gàidhlig · galego · Hausa · hrvatski · Igbo · interlingua · Interlingue · isiXhosa · isiZulu · íslenska · italiano · Kiswahili · Kreyòl ayisyen · kréyòl gwadloupéyen · Kurdî · latviešu · Lëtzebuergesch · lietuvių · magyar · Malagasy · Malti · Nederlands · Nedersaksies · norsk bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tiếng Việt · Türkçe · Vahcuengh · vèneto · Wolof · Yorùbá · Zazaki · српски / srpski · беларуская · български · қазақша · македонски · монгол · русский · тоҷикӣ · українська · Ελληνικά · Հայերեն · ქართული · नेपाली · मराठी · हिन्दी · भोजपुरी · অসমীয়া · বাংলা · ਪੰਜਾਬੀ · ગુજરાતી · ଓଡ଼ିଆ · தமிழ் · తెలుగు · ಕನ್ನಡ · മലയാളം · සිංහල · བོད་ཡིག · ไทย · မြန်မာဘာသာ · ລາວ · ភាសាខ្មែរ · ⵜⴰⵎⴰⵣⵉⵖⵜ ⵜⴰⵏⴰⵡⴰⵢⵜ‎ · አማርኛ · 한국어 · 日本語 · 中文(简体)‎ · 中文(繁體)‎ · 吴语 · 粵語 · ייִדיש · עברית · اردو · العربية · پښتو · سنڌي · فارسی · ދިވެހިބަސް
その他の言語このウィキの翻訳を支援してください
Public-images-osm logo.svg opening_hours
Neon Internet Cafe open 24 hours.jpg
説明
何かがいつ開いていつ閉まるかを記述します。このデータには標準の書式があります。
グループ: 属性
適用できる要素
ノードに使用可能ウェイに使用可能領域に使用可能use on relations unspecified
関連項目
状態: 事実上の標準

営業時間が知られているものであればほとんどすべて、 opening_hours=* によって営業時間を記入することが可能です。スーパーマーケットや小規模なコンビニエンスストアは同じ国であっても(同じ都市の中ですら)閉店時間が異なり、大都市部では一晩中開いている小さな店がよくみかけられます。24時間年中無休の薬局やガソリンスタンド、パブ、ファストフード店もあります。夜間に特定の施設を探す際、このような情報はとても重要です。

加えて、現在の営業時間を参照できる URL を、 opening_hours:url=http://example.org/ でタグ付けすることもできます。

このページを読む前に、 Proposed features/Time domainsJA:Key:opening_hours/仕様に注意してください。


文法の概要

多くの場面に対応できる概要を示します。 opening_hours タグを完全な文法の説明ではなく、短い時間で書けるようになることを目指しています。もっと複雑な場面では、以降の節にある文章や仕様の全体追加の説明を参照してください。
評価ツール、またはより単純な YoHours アプリケーションを使用すると、組み立てた値をチェックできます。

注: Anyone being sure to have understood something upon which everyone agrees and that's different from this syntax explanation is welcome to make the correction in it.

凡例
コード はそのまま記述されます(必要な空白文字   を含めます。それ以外の文法内の空白文字は実際には入れません)。
要素 は以下の 要素: で始まる行で文法が定義されている 要素 に置き換えられます。
項目... はその 項目 が必要なだけ繰り返されることを示します。
[ 一連の項目 ] は、 一連の項目 が任意であることを示します。
| は(この記号で区切られた)一連の項目のうち一つを選択することを示します。
全般的な文法
opening_hours= ルールセット [ ; ルールセット ]...
それぞれの ルールセット は順番に評価され、後の ルールセット は以前の ルールセット と一致した開店・閉店の状態を上書きする可能性があります。
ルールセット: ルール [ || ルール ]...
それぞれの ルール は示されている日付や時刻に一致するか、 ルールセット 内にある次の ルール がフォールバックとしてのみチェックされるまで、順番に評価されます。
ルール: 範囲 [ 状態 ] [ コメント ]
範囲: [ 年の定義 ] 日付の定義 [   時間の定義 ] | 時間の定義 | 24/7
任意の年を指定する文法
年の定義: 年の範囲 [ , 年の範囲 ]...
年の範囲: [ - | + ] [ / n ]
任意で、 で指定された年から始まる年数を n 年と指定できます。
: はグレゴリオ暦における4桁の年号です。
日付を指定する文法(任意の時間を含む)
日付の定義: 月次 | 週次 | 日次 | 変動日の定義 | 祝日
月次: 日の定義 [   曜日の定義 ]
週次: [ week   週の範囲 [ , 週の範囲 ]...   ] 曜日の範囲 [ , 曜日の範囲 ]...
日次: 月の定義 [   日の定義 [ , 日の定義 ]... ]
変動日の定義: 変動日 [ - 変動日 ]
月の定義: [ - ]
日の定義: [ - ]
週の範囲: 週番号 [ - 週番号 | + ] [ / n ]
任意で、 週番号 で指定された週から始まる週の数を n 週と指定できます。
曜日の定義: 曜日の範囲 [ , 曜日の範囲 ]... | 曜日[ n [ , n ]... ]
曜日の後に番号が付くことがあり、正の数ならば月初から数えて第n週、負の数ならば月末から数えて第n週を示します。
e.g. Mo-Fr 08:00-09:00, or Mo[1,3] 08:00-09:00;
e.g. Su[1] は月の第1日曜日を表し、 Su[-1] は月の最終日曜日を表します。
曜日の範囲: 曜日 [ - 曜日 ]
週番号: (ISO 年の)週番号を2桁(01-53)で、例えば week 25 Mo 08:30-20:00
: 日を2桁(01-31)で、例えば Dec 25
: Jan | Feb | Mar | Apr | May | Jun | Jul | Aug | Sep | Oct | Nov | Dec
英語の月名を3文字に略したもの、例えば Dec 25
曜日: Mo | Tu | We | Th | Fr | Sa | Su
英語の曜日名を2文字に略したもの、例えば Fr 08:30-20:00
変動日: 祭日 [ 符号 n days ]
祭日: easter
現在のところ、定義されている変動する祭日はイースターのみです(キリスト教のグレゴリオ暦による)。
祝日: PH | SH
PH 国民の祝日(地域による、国や地域別のデータが必要)、または、 SH 学校休日(地域による、学校ごとのデータが必要)
時間を指定する文法
時間の定義: 時間の範囲 [ , 時間の範囲 ]...
時間の範囲: 時刻 [ - 時刻 | + ]
時刻: 固定時刻 | 変動時刻
固定時刻: HH : mm
変動時刻: イベント | ( イベント 相対時刻 )
イベント: dawn | sunrise | sunset | dusk
Note that sunset and sunrise times requires geolocation to compute the position angular elevation of the sun, and the the angular elevation of the observable horizon (which is also dependant of the altitude). They may be approximated at sea level on the modeling geoid, or just estimated roughly in local time (per country and time zone).
相対時刻: 符号 hh : mm
hh: 相対的な時を2桁(00-48)で、例えば (sunrise+01:00)-12:00
HH: 絶対的な時を2桁(00-23)で(1日の中で、午前・午後ではなく24時制で)、例えば Fr 08:30-20:00
mm: (時間の中の)分を2桁(00~59)で、例えば Fr 08:30-20:00
その他の日付や時刻を調整するために使われる全般的な文法要素
符号: + | -
n: 正の整数。
任意の修飾子の文法
状態: unknown | open | closed | off
unknown: initial open or closed state, except at overriding dates and times that follow (may also be used to override a previous explicit open or closed status);
open: open at the indicated dates and times (or permanently if no time is given), except at overriding dates and times that follow;
closed or off: closed at the indicated dates and times (or permanently if no time is given), except at overriding dates and times that follow;
In each ルール of the first ルールセット of the tag value (including fallbacks), if the 状態 is not explicitly specified with the specified 範囲, it is assumed to be meant as open, leaving all other unspecified dates and times as unknown; the resulting schedule is then successively modified by each following ルールセット.
コメント: "text"
A short comment (not containing any ") showing applicable restrictions or specifications, e.g. "children only", "limited service", or "reservation by phone".
This comment is intended to be displayed in applications and not to be interpreted automatically. The language used in this comment is not specified by the tag value itself, but this could be specified (for localisation purpose) by tags whose key contains a language code suffix.

マッピング方法

性質を表すタグなので、以下のような関連タグとともに使用します。例)

ウェイ ウェイ をタグ付けする前に JA:Key:access を参照してください。

The evaluation tool and YoHours are webtools which help to determine the values. Please use English for weekday and month names.

  • 24/7
    適用例:24時間年中無休のすべての施設(関連タグ)
    地図上でのレンダリング:オブジェクトアイコンに24が付いたもの
  • Sa-Su 00:00-24:00
    適用例:週末のみの営業だが24時間営業
  • Mo-Fr 08:30-20:00 あるいは以下のようにより複雑な営業時間:
    Mo 10:00-12:00,12:30-15:00; Tu-Fr 08:00-12:00,12:30-15:00; Sa 08:00-12:00
    Mo-Su 08:00-18:00; Apr 10-15 off; Jun 08:00-14:00; Aug off; Dec 25 off
    適用例:営業時間をもつすべての施設(関連タグ)
    地図上でのレンダリング:されません。情報はソフトウェアにより復元されます。
  • Mo-Sa 10:00-20:00; Tu off または Mo-Sa 10:00-20:00; Tu 10:00-14:00
    週の途中に休業日がある場合
    適用例:営業時間をもつすべての施設(関連タグ)
    地図上でのレンダリング:されません。情報はソフトウェアにより復元されます。
  • sunrise-sunset
    適用例:毎日日の出から日没まで営業
    時間のオフセットを付ける場合は丸括弧 () を使用してください。例えば、ある公園が日の出時刻の2時間後から日の入り時刻の2時間前まで開いているような場合には (sunrise+02:00)-(sunset-02:00) となります。
  • Su 10:00+
    日曜日 10:00 開店で閉店時間は不明
    適用例:営業時間をもつすべての施設(関連タグ)
    地図上でのレンダリング:されません。情報はソフトウェアにより復元されます。
  • week 1-53/2 Fr 09:00-12:00; week 2-52/2 We 09:00-12:00
    奇数週は金曜日、偶数週は水曜日、09:00-12:00に開店。
    適用対象:営業時間があるすべての施設
    地図上でのレンダリング:されません。情報はソフトウェア処理されます。


  • Mo-Sa 08:00-13:00,14:00-17:00 || "by appointment"
    フォールバックルールを適用する例です。前のルールが適用されなかったすべての時間帯に適用されます。
  • Su-Tu 11:00-01:00, We-Th 11:00-03:00, Fr 11:00-06:00, Sa 11:00-07:00
    後ろのあるルールは前のルールを上書きすると決められているので、深夜をまたぐ時間帯を指定する場合は、セミコロンではなくコンマを使います。
  • Mo-Su,PH 15:00-03:00; easter -2 days off
    祝日を含む毎日開店するが、聖金曜日(イースター前の金曜日)は休み。

記法

  • wd weekday, available: Mo · Tu · We · Th · Fr · Sa · Su (e.g., > Fr 08:30-20:00)
  • hh hour, always two digits number in 24h basis (no am/pm), in the format "hh:mm" · (e.g., > Fr 08:30-20:00)
  • mm minute, always two digits number in the format "hh:mm" (e.g., > Fr 08:30-20:00)
  • mo month, available: Jan · Feb · Mar · Apr · May · Jun · Jul · Aug · Sep · Oct · Nov · Dec · "mo md" (e.g., > Dec 25)
  • md monthday, always two digits number in the format · "mo md" (e.g., > Dec 25)
  • we week number, always a two digit number in range 01-53, in the format "week we" (e.g., > week 25 Mo 08:30-20:00)
  • SH 学校の休日(夏休みなどを含む)。学校休日で営業日が異なる場合に使用する。 (e.g., Mo-Fr 08:00-09:00,14:00-15:00; SH off)[1]
  • PH 祝日。祝日で営業日が異なる場合に使用する。 (e.g., Mo-Fr 09:00-17:00; PH 10:00-12:00; PH Su off)[1]
上の例は、通常営業時間が月-金の午前9時〜午後5時で、祝日の営業時間は午前10時〜午後12時、祝日が日曜日の場合は休みであることを意味しています。

The general syntax for the value is: hh:mm-hh:mm (e.g., > 08:30-20:00)

The general syntax for the value is: wd hh:mm-hh:mm (e.g., > Fr 08:30-20:00)

The general syntax for the value is: mo md: hh:mm-hh:mm (e.g., > Dec 25: 08:30-20:00) Note that the colon is optional as mentioned under Key:opening_hours/specification

The general syntax for the value is mo-mo: wd hh:mm-hh:mm (e.g., Jun-Aug: Su 10:30-16:00 to specify the opening times on Sundays in June, July and August. Note that the colon is optional as mentioned under Key:opening_hours/specification).

The general syntax for the value is: week we: wd hh:mm-hh:mm (e.g., > week 25: Mo 08:30-20:00) Note that the colon is optional as mentioned under Key:opening_hours/specification

規則

  • 連続する時間(常に開店時間-閉店時間の形)は "-" で区切ります。 例)08:30-20:00
  • Consecutive weekdays open separated by "-" · (e.g., > Mo-Fr)
  • Consecutive monthdays open separated by "-" · (e.g., > Dec 20-26) or (e.g., > Dec 20-Jan 06)
  • Open with periodicity "n" within a range of consecutive monthdays, the range is followed by "/n" (e.g., > 02-30/n)
  • Consecutive weeks open separated by "-" · (e.g., > week 01-26)
  • Open with periodicity "n" within a range of consecutive weeks, the range is followed by "/n" ( e.g.> week 02-52/n )
  • A break on days separated by "," · (e.g., > Mo,We,Fr)
  • A break on hours separated by "," · (e.g., > 08:30-14:00,16:30-20:00)
  • 日によって営業時間が異なる場合は ";" で区切られます。 例)Mo 10:00-12:00,12:30-15:00; Tu-Fr 08:00-12:00,12:30-15:00; Sa 08:00-12:00
reads as: this opening hours for this days ; this opening hours for this days
  • A weekday off will be tagged as "wd off" (e.g., > Tu off)
  • A range of weekdays off will be tagged as "wd-wd off" (e.g., > Tu-Th off)
  • A month off will be tagged as "mo off" (e.g., > Aug off )
  • A range of months off will be tagged as "mo-mo off" (e.g., > Aug-Sep off)
  • A monthday off will be tagged as "mo md off" (e.g., > Dec 25 off)
  • A range of monthdays off will be tagged as "mo md-md off" (e.g., > Dec 24-26 off) or "mo md - mo md off" (e.g., > Dec 25-Jan 06 off )
  • Exceptions to a range of days, first the range then the exception (e.g., > Mo-Sa 10:00-20:00; Tu off) or (e.g., > Mo-Sa 10:00-20:00; Tu 10:00-14:00) or (e.g., > Mo-Fr 08:00-12:30; We 14:00-17:00)
This means these are not additions, for example Mo-Fr 08:00-12:30; We 14:00-17:00 means that on Wednesdays, the shop is only opened in the afternoons and not additionally.
  • If it is in the first or last day of a range then don't use the exception rule, use the usual (e.g., > Mo-Fr 10:00-20:00; Sa 10:00-14:00)
  • Non-consecutive or semi-consecutive days of the week will be tagged as wd[x] (e.g., Su[3] 09:00-12:00)
This is used to indicate the 3rd Sunday of the month from 9am to 12pm.
Use -1 to indicate the last day of the month; e.g., Aug Th[-1] means last Thursday in July.
Can use grouping, (e.g., Su[1,3,5] and Su[1-3])
  • If hours are non stop some days then (e.g., > 00:00-24:00)
  • If it is 24 hours 7 days a week it has a specific value: 24/7
this way it can render a specific icon.
  • A special time value to mark the time the sun rises is: sunrise.
  • A special time value to mark the time the sun sets is: sunset.
  • A + after a time means "from" or "open end" (e.g., Sa 22:00+ or Sa 18:00-22:00+)

See the formal specification for more details.

Common mistakes

  • 7/8-23 (incorrect) → Mo-Su 08:00-23:00 (correct)
  • 0600-180006:00-18:00
  • 07;00-2;00pm07:00-14:00
  • 08.00-16.00, public room till 03.00 a.m08:00-16:00 open, 16:00-03:00 open "public room"
  • 09:00-21:00 TEL/072(360)320009:00-21:00 "call us" (and add contact:phone=*)
  • 10:00 - 13:30 / 17:00 - 20:3010:00-13:30,17:00-20:30
  • April-September; Mo-Fr 09:00-13:00, 14:00-18:00, Sa 10:00-13:00 -> Apr-Sep: Mo-Fr 09:00-13:00,14:00-18:00; Apr-Sep: Sa 10:00-13:00
  • Dining in: 6am to 11pm; Drive thru: 24/7 -> 06:00-23:00 open "Dining in" || 00:00-24:00 open "Drive-through"
  • MWThF: 1200-1800; SaSu: 1200-1700 -> Mo,We,Th,Fr 12:00-18:00; Sa-Su 12:00-17:00
  • BAR: Su-Mo 18:00-02:00; Tu-Th 18:00-03:00; Fr-Sa 18:00-04:00; CLUB: Tu-Th 20:00-03:00; Fr-Sa 20:00-04:00 -> Tu-Th 20:00-03:00 open "Club and bar"; Fr-Sa 20:00-04:00 open "Club and bar" || Su-Mo 18:00-02:00 open "bar" || Tu-Th 18:00-03:00 open "bar" || Fr-Sa 18:00-04:00 open "bar"
  • Su-Th 11:00-03:00; Fr-Sa 11:00-05:00 -> Su-Th 11:00-03:00, Fr-Sa 11:00-05:00 See last example
  • Mo-We 17:00-01:00; Th,Fr 15:00-01:00; PH,Sa,Su off -> Mo-We 17:00-01:00, Th,Fr 15:00-01:00; PH off. Use additional rules. You can not say "Sa,Su off" because that would set the time "Sa 00:00-01:00" to closed.

実装

JavaScript

JavaScript implementation by User:Ypid:

JavaScript library

JavaScript library by User:AMDmi3 (on which the work from User:Ypid is based on).


OsmAnd

OsmAnd 2.0 showing whether the POI is known to be open or closed based on tagging of opening_hours. For example, the Re-CYCLE Bike Shop was closed when the screenshot was taken; however, the various bicycle rental facilities were open.

OsmAnd uses this tag in the POI search screen. The implementation is only partial, currently no dates, weeknumbers or holidays are supported, but most values should get parsed.

Opening hours for Ulm, Neu-Ulm & surroundings

Ulm, Neu-Ulm and surrounding areas.

The web application is available on http://ulm-oeffnungszeiten.creal.de. Opening hours for the local area are visualized on a map. The source code of this application is freely licensed and available via GitHub. Adapting the application to a different city is very easy and described on the GitHub page.

More Maps and Applications

  • Hoursome (for iOS devices)
  • My Opening Hours (for Android devices)
  • statistics Visualization of the data quality and growth over time.
  • YoHours カレンダー上で時間をドラッグするだけで opening_hours を作れるウェブサイトです。

コード

レンダリング

In the case of 24/7 it can be something like adding a 24 to the object icon.

Pharmacy dispencing 24.png

The rest of values have no obvious rendering and may be accessed with context menu or alike.

以前の非推奨になったタグ

The following (undocumented) keys have been deprecated and should be replaced by this opening_hours=*. Their value should be interpreted to set the value of the new key, as described above:

See also Conditional_restrictions.

関連項目

脚注

  1. 1.0 1.1 The default holidays can be added to opening_hours.js. There is an alternative system for default values which is currently not evaluated by opening_hours.js: Default is a proposal for a default values system. This proposal can set default values such as maxspeed for areas (countries, states...) but also holidays periods. A country, a zone area can subscribe to a default containing such holidays definitions.