Pt:Key:opening_hours
opening_hours |
Descrição |
---|
Descreve o horário de funcionamento de um estabelecimento ou elemento. Para ver o formato padrão específico para estes dados, consultar a wiki. |
Grupo: propriedades |
Usado nos elementos |
Ver também |
Situação: de facto |
Ferramentas |
Descrição
A chave opening_hours=*
é adicionada a um elemento para descrever o seu horário de funcionamento. operação. É possível usá-la em qualquer estabelecimento que tenha um período de funcionamento definido. Supermercados e pequenas lojas de conveniência fecham na maioria dos países e em diferentes momentos (mesmo na mesma cidade). Nas áreas metropolitanas, é comum haver pequenas lojas abertas toda a noite. Algumas farmácias, postos de gasolina, bares e restaurantes de fast-food estão abertos 24/7. Esta é uma informação muito importante para quem procurar um determinado estabelecimento à noite.
Também se pode indicar o URL onde os horários de abertura podem ser pesquisados com
opening_hours:url=https://exemplo.org
.
Para uma descrição mais pormenorizada sobre esta chave, consultar a seguinte página (em inglês): Key:opening_hours/specification.
Exemplos simples
Aberto nos dias úteis
- Deve-se usar as abreviações em inglês, como na seguinte tabela:
Abreviação | Dia da semana |
---|---|
Mo | Segunda-feira |
Tu | Terça-feira |
We | Quarta-feira |
Th | Quinta-feira |
Fr | Sexta-feira |
Sa | Sábado |
Su | Domingo |
Vários intervalos de abertura
opening_hours=Mo-Fr 08:00-12:00,13:00-17:30 |
igual ao exemplo em cima, mas fechado das 12h00 às 13h00 |
- Adicionar os dois intervalos de abertura, separados por uma vírgula (,)
Vários dias
opening_hours=Mo-Fr 08:00-12:00,13:00-17:30; Sa 08:00-12:00 |
igual ao exemplo anterior, mas também aberto aos sábados de manhã |
- Adicionar as horas de abertura para cada intervalo de dias, separados por um ponto e vírgula e um espaço (; )
Encerrado aos feriados
opening_hours=Mo-Fr 08:00-12:00,13:00-17:30; Sa 08:00-12:00; PH off |
igual ao exemplo anterior, mas encerrado nos feriados públicos |
- Usar
PH
como se fosse um dia da semana. Em vez das horas, usaroff
para indicar que está encerrado o dia inteiro. - Usar
SH
para feriados escolares. Embora isto seja raro, também se pode usarPH
eSH
no mesmo elemento. Por exemplo: opening_hours=Mo-Fr 08:00-12:00,13:00-17:30; Sa 08:00-12:00; PH off; SH off
Horas diferentes nos feriados
opening_hours=Mo-Fr 08:00-12:00,13:00-17:30; Sa 08:00-12:00; PH 09:00-12:00 |
nos feriados, está aberto das 09h00 às 12h00 |
- Como indicado no exemplo anterior,
PH
é como um dia da semana. Como está à direta das restantes regras, sobrepõe-se a elas. Para mais informações sobre quais as regras que têm precedências, consultar este guia mais elaborado.
Exemplos mais complexos
- 24/7
- Aplicado em: instalações que não fecham (tags relacionadas), 24 horas por dia, 7 dias por semana
- Renderização no mapa: ícone de objeto com um 24
- Sa-Su 00:00-24:00
- Abre nas 24 horas de sábado e domingo.
- Mo-Fr 08:30-20:00 ou para horários de abertura mais complexos:
- 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; Abr 10-15 off; 08:00-14:00; Aug off; Dec 25 off
- Mo-Sa 10:00-20:00; Tu off ou Mo-Sa 10:00-20:00; Tu 10:00-14:00
- Para exceções num intervalo de dias.
- sunrise-sunset
- Abre todos os dias entre o nascer e o pôr-do-sol.
- Usar parêntesis redondos para adicionar um deslocamento de tempo. Por exemplo, um parque que abre 2 horas após o nascer do Sol e fecha 2 horas antes do nascer do Sol (sunrise+02:00)-(sunset-02:00)
- Su 10:00+
- Aberto aos domingos, das 10h00 a uma hora de encerramento desconhecida ou não especificada.
- week 1-53/2 Fr 09:00-12:00; week 2-52/2 09:00-12:00
- Aberto das 09h00 às 12h00 às sextas-feiras das semanas ímpares e às quartas-feiras das semanas pares
- Mo-Sa 08:00-13:00, 14:00-17:00 || "por nomeação"
- Aqui, a regra fallback rule é útil. Aplica-se a qualquer horário que não foi abordado em exemplos anteriores.
- Su-Tu 11:00-01:00, We-Th 11:00-03:00, Fr 11:00-06:00, Sa 11:00-07:00
- Por causa da definição de que as regras à direita substituem as precedentes, os horários que passam da meia-noite (00h00) devem usar regras adicionais que são separadas por vírgulas em vez de ponto e vírgula.
- PH Mo-Su 15:00-03:00; easter -2 days off
- Aberto todos os dias, incluindo feriados, mas fechado na sexta-feira de Páscoa.
- Para mais exemplos, consultar a ferramenta de avaliação e a documentação de opening_hours.js.
Resumo da sintaxe
Este é um resumo que cobre a maioria dos casos. O objetivo é permitir a escrita da maioria das etiquetas de horário de abertura em pouco tempo e não explicar a sintaxe na sua totalidade. Para casos mais complexos, consultar especificação completa e mais explicações.
- Sintaxe geral
opening_hours=
conjunto de regras [;
conjunto de regras ]...- Cada conjunto de regras é avaliado por ordem, o conjunto de regras seguinte irá sobrepor-se ao estado inicial aberto ou fechado que pode ter sido combinado no conjunto de regras anteriores.
- conjuntos de regras: regra [
||
regra ]...- Cada regra é avaliada em ordem até corresponder às datas ou horas indicadas, caso contrário a regra seguinte do conjunto de regras só será verificada como um fallback.
- regra : intervalo [ status ] [ comentário ]
- intervalo: [ anos ] datas [
;
horas ] | horas |24/7
- Sintaxe para especificar anos opcionais
- anos: intervalo_de_anos [
,
intervalo_de_anos ] ... - intervalo de anos: ano [
-
ano |+
] [/
n ]- Pode ser especificado um período opcional de n anos para anos a incluir dentro do intervalo especificado, começando no primeiro ano especificado.
- ano: um ano com 4 dígitos no calendário gregoriano.
- Sintaxe para especificar datas (com horários opcionais)
- datas: monthly | weekly | daily | variably | holidays
- mensalmente: dias do mês [
- semanalmente: [
week
;
week_range [,
week_range ] ...;
] weekday_range [,
weekday_range ] ... - diariamente: months [
;
monthdays [,
monthdays ] ...] - variável: variable_date [
-
variable_date ] - meses: Mth [
-
Mth ] - dias do mês: dd [
-
dd ] - intervalo de semanas: ww [
-
ww |+
] [/
n ]- Um período opcional de n semanas pode ser especificado por semanas para incluir dentro do intervalo especificado a partir do primeiro número de semana ww especificado.
- dias da semana: weekday_range [
,
weekday_range ] ... | Wd[
n [,
n ] ...]
- Os dias de semana podem ser seguidos por números de classificação, contados positivamente a partir do início do mês, ou negativamente a partir do final do mês:
- por exemplo.
Mo-Fr 08:00-09:00
, ouMo [1,3] 08:00-09:00
; - por exemplo.
Su [1]
significa o primeiro domingo do mês eSu [-1]
significa o último domingo do mês.
- intervalo de dias da semana: Wd [
-
Wd ] - ww: Um número de semana de 2 dígitos (no ano ISO) no intervalo 01-53, exemplo:
week 25 Mo 08:30-20:00
- dd: Um número mensal de 2 dígitos no intervalo 01-31, exemplo:
Dec 25
- Mth:
Jan
|Feb
|Mar
|Apr
|May
|Jun
|Jul
|Aug
|Sep
|Oct
|Nov
|Dec
- Um nome de mês em inglês abreviado de 3 letras, p.ex.
Dec 25
- Um nome de mês em inglês abreviado de 3 letras, p.ex.
- Wd:
Mo
|Tu
|We
|Th
|Fr
|Sa
|Su
- Um nome abreviado de dia de semana em inglês de duas letras, exemplo:
Fr 08:30-20:00
- Um nome abreviado de dia de semana em inglês de duas letras, exemplo:
- dara variável: yearly_fest [ valor n
days
] - feriado anual:
easter
Por enquanto, o único feriado anual variável especificado é a Páscoa (assumindo o calendário gregoriano cristão). - feriados:
PH
|SH
- Feriado público (dependente da localização, requer dados por país / região); feriado escolar (dependente da localização, requer dados por academia escolar).
- Sintaxe para especificar horas
- horas: time_range [
,
time_range ] ... - intervalo de horas: time [
-
time |+
] - hora: fixed_time | variable_time
- hora fixa: HH
:
mm - hora variável: evento |
(
evento offset_time)
- evento:
dawn
|sunrise
|sunset
|dusk
- Observe que o mais importante é a elevação angular do Sol e a elevação angular do horizonte observável (que também depende da altitude). Eles podem ser aproximados, sem alocação, sem geografia de modelo, ou apenas estimados aproximadamente na hora local (por país e fuso horário).
- desfasamento horário: sign hh
:
mm - hh: Um número relativo de horas de 2 dígitos sem intervalo 00-48, exemplo:
(sunrise + 01:00) -12:00
. - HH: Um número absoluto de horas de 2 dígitos (no dia, no formato 24h, não am/pm) no intervalo 00-23, e.
Fr 08:30 - 20:00
. - mm: Um número de minutos de 2 dígitos (na hora) no intervalo 00-59, e.
Fr 08:30 - 20:00
.
- Outros elementos genéricos usados para refinar dados e horas
- valor :
+
|-
- n: Um número inteiro positivo.
- Sintaxe para modificadores opcionais
- estado:
unknown
|open
|closed
|off
unknown
: estado inicial aberto ou fechado, exceto nas datas e horas principais que se seguem (também pode ser usado para substituir um estado aberto ou fechado explícito anterior);open
: abre nas datas e horários indicados (ou permanentemente, se não houver tempo), exceto nas datas e horas principais que se seguem;closed
ouoff
: fechado nas datas e horas indicadas (ou permanentemente, se não houver tempo), exceto nas datas e horas principais que se seguem;- Em cada regra do primeiro conjunto de regras do valor da etiqueta (incluindo os backbacks), se o status não for explicitamente especificado com o intervalo, é assumido como sendo
open
, deixando todas as outras datas e horas não especificadas comounknown
; A programação resultante é sucessivamente modificada por cada seguinte conjunto de regras.
- comentário:
"
texto"
- Um breve comentário (envolvido em
"
mas não contendo nenhum"
dentro) mostrando as restrições ou especificações aplicáveis, por exemplo,"somente para crianças"
,"serviço limitado"
, ou"reserva por telefone"
. - Este comentário pretende ser exibido em aplicativos e não deve ser interpretado automaticamente. O idioma utilizado neste comentário não é especificado pelo próprio valor da etiqeuta, mas isso pode ser especificado (para fins de localização) por etiquetas cuja chaves contêm um sufixo de código de idioma.
- Um breve comentário (envolvido em
Sintaxe
- wd dia da semana, disponível: Mo • Tu • We • Th • Fr • Sa • Su (por exemplo,> Fr 08:30-20:00)
- hh hora, sempre número de dois dígitos em 24h (não am/pm), no formato "hh:mm" • (por exemplo,> Fr 08:30-20:00)
- mm minuto, sempre dois dígitos no formato "hh:mm" (por exemplo,> Fr 08:30-20:00)
- mo mês, disponível: Jan • Fev • Mar • Abr • Maio • Jun • Jul • Ago • Set • Out • Nov • Dec • "mo md" (por exemplo,> Dec 25)
- md dia do mês, sempre número de dois dígitos no formato • "mo md" (por exemplo,> Dec 25)
- we número da semana, sempre um número de dois dígitos no intervalo 01-53, no formato "week we" (por exemplo,> semana 25 Mo 08:30-20:00)
- SH feriado escolar, pode ser usado para indicar diferentes horas de abertura durante as férias escolares (por exemplo, Mo-Fr 08:00-09:00,14:15-15:00; SH off)
- PH feriado público, pode ser usado para indicar horários de abertura diferentes durante os feriados públicos (por exemplo, Mo-Fr 09:00-17:00; PH 10:00-12:00; PH Su off)
- O exemplo acima significa que as horas normais são de segunda a sexta-feira das 9h às 17h, exceto nos feriados públicos das 10h às 12h, exceto os feriados públicos que caem em um domingo.
A sintaxe geral para o valor é: hh:mm-hh:mm (por exemplo,> 08:30-20:00).
A sintaxe geral para o valor é: wd hh:mm-hh:mm (por exemplo,> Fr 08:30-20:00).
A sintaxe geral para o valor é: mo md:hh:mm-hh:mm (por exemplo,> Dec 25: 08:30-20:00). Observe que o sinal de dois-pontos é opcional conforme mencionado em Key:opening_hours/specification.
A sintaxe geral para o valor é: mo-mo:wd hh:mm-hh:mm (por exemplo, Jun-Aug:Su 10:30-16:00 para especificar o horários nos domingos em junho, julho e agosto). Observe que o sinal de dois-pontos é opcional conforme mencionado em Key:opening_hours/specification.
A sintaxe geral para o valor é: week we:wd hh:mm-hh:mm (por exemplo,> semana 25: Mo 08:30-20:00). Observe que o sinal de dois-pontos é opcional conforme mencionado em Key:opening_hours/specification.
Regras
- Horas consecutivas [precisa sempre de horário de abertura-horário de encerramento] separadas por "-" (por exemplo,> 08:30-20:00)
- Dias consecutivos abertos separados por "-" (por exemplo,> Mo-Fr)
- Meses consecutivos abertos separados por "-" (por exemplo,> Dec 20-26) ou (por exemplo,> Dez 20-Jan 06)
- Abrir com periodicidade "n" dentro de um intervalo de meses consecutivos, o intervalo é seguido por "/n" (por exemplo,> 02-30/ n)
- Semanas consecutivas abertas separadas por "-"(por exemplo,> semana 01 - 26)
- Abrir com periodicidade "n" dentro de um intervalo de semanas consecutivas, o intervalo é seguido por "/n" (por exemplo, semana 02-52 /n)
- Uma interrupção nos dias separados por "," · (por exemplo,> Mo , We , Fr)
- Uma interrupção nas horas separadas por "," · (por exemplo,> 08:30-14: 00 , 16:30-20:00)
- Diferentes horas em dias diferentes são separadas por ";" (por exemplo,> Mo 10: 00-12:00,12:30-15:00 ; Tu-Fr 08:00-12:00,12:30-15:00 ; Sa 08:00-12:00)
- lê-se como: horário de funcionamento para este dia ; horário de funcionamento para estes dias ; horário de funcionamento para este dia
- Um dia de semana fechado será marcado como "wd off" (por exemplo,> Tu off)
- Um intervalo de dias úteis fechado será marcado como "wd-wd off" (por exemplo,> Tu-Th off)
- Um mês fechado será marcado como "mo off" (por exemplo,> Aug off)
- Um intervalo de meses fechado será marcado como "mo-mo off" (por exemplo,> Aug-Sep off)
- Um dia do mês fechado será marcado como "mo md off" (por exemplo,> Dec 25 off)
- Um intervalo de meses fechado será marcado como "mo md-md off" (por exemplo,> Dec 24-26 off) ou "mo md - mo md off" (por exemplo,> Dec 25-Jan 06 off)
- Exceções para um intervalo de dias, primeiro o intervalo, em seguida, a exceção (por exemplo,> Mo-Sa 10:00-20:00; Tu off) ou (por exemplo,> Mo-Sa 10:00-20:00; Tu 10:00-14:00) ou (por exemplo,> Mo-Fr 08:00-12:30; We 14:00-17:00)
- Isto significa que não são adições. Por exemplo, Mo-Fr 08:00-12:30; We 14:00-17:00 significa que às quartas-feiras, a loja só está aberta à tarde e não adicionalmente.
- Se estiver no primeiro ou último dia de um intervalo, não se deve usar a regra de exceção, mas o usual (por exemplo,> Mo-Fr 10:00-20:00; Sa 10:00-14:00)
- Os dias não consecutivos ou semiconsecutivos da semana serão marcados como wd [x] (por exemplo, Su [3] 09:00-12:00)
- Isto é usado para indicar o 3.º domingo do mês das 9 às 12 horas.
- Usar -1 para indicar o último dia do mês; por exemplo, Aug Th[-1] significa a última quinta-feira de agosto.
- Pode-se usar agrupamentos (por exemplo,> Su[1,3,5] e Su[1-3])
- Se as horas são seguidas em determinados dias: (por exemplo,> 00:00-24:00)
- Se estiver aberto 24 horas por dia nos 7 dias da semana, há o valor específico: 24/7.
- Desta forma, usará um ícone de redenreização específico.
- Um valor de tempo especial para marcar a hora em que o Sol nasce é: sunrise.
- Um valor de tempo especial para marcar a hora em que o Sol se põe é: sunset.
- O + depois de uma hora significa "a partir de" ou "encerramento aberto" (por exemplo,> Sa 22:00+ ou Sa 18:00-22:00+)
Ver Key:opening_hours/specification para mais detalhes.
Erros comuns
Incorreto | Correto | Notas |
---|---|---|
7/8-23 | Mo-Su 08:00-23:00 | |
0600-1800 | 06:00-18:00 | |
07;00-2;00pm | 07:00-14:00 | |
08.00-16.00, sala pública até 03.00 a.m | 08:00-16:00 open, 16:00-03:00 open "sala pública" | |
09:00-21:00 TEL/072(360)3200 | 09:00-21:00 "ligue-nos" | Adicionar contact:phone=072-360-3200 |
10:00 - 13:30 / 17:00 - 20:30 | 10: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 | |
Jantar no interior: 6am to 11pm; Drive thru: 24/7 | 06:00-23:00 open "Jantar no interior" || 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; CLUBE: Tu-Th 20:00-03:00; Fr-Sa 20:00-04:00 | Tu-Th 20:00-03:00 open "Clube e bar"; Fr-Sa 20:00-04:00 open "Clube e 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 | Ver último exemplo |
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 | Usar regras adicionais. Não se pode usar "Sa,Su off" porque isso marcaria o horário definido "Sa 00:00-01:00" como fechado. |
Implementação
OsmAnd
O OsmAnd usa esta chave na tela de pesquisa de POI. A implementação inclui agora mais valores (como meses e datas), com suporte para restrições condicionais.
Mais mapas e aplicativos
Web:
- openingh.openstreetmap.de / openingh.ypid.de - mapa com camada para a chave
opening_hours=*
- Qwant Maps - motor de busca com mapa OSM que também mostra os horários de abertura dos POI
Aplicações móveis:
- My Opening Hours - para dispositivos Android
- Vespucci - editor OSM completo para Android
- StreetComplete - editor OSM que permite recolher, entre outros dados, informação de horários de abertura
Ferramentas:
- ulm API - A aplicação web está disponível em http://ulm-oeffnungszeiten.creal.de. As horas de abertura da área local são visualizadas num mapa. O código-fonte deste aplicativo é livremente licenciado e disponível através do GitHub. É muito fácil adaptar o aplicativo a uma cidade diferente. As informações estão na página do GitHub.
- statistics - visualização da qualidade e crescimento dos dados ao longo do tempo
- YoHours - um sítio para criar horários de abertura arrastando intervalos de tempo num calendário
JavaScript
Implementação JavaScript por User:Ypid:
- ferramenta de avaliação
- código fonte
- Mapa que mostra elementos com horários de funcionamento
- script Python para pesquisar com regex e carregar valores que não podem ser avaliados no JOSM (documentação em README).
- Segue aespecificação formal originalmente criada por Netzwolf.
- Baseado no código inicial e conceito criados por AMDmi3.
Java
- OpeningHoursParser Parser library
- OpeningHoursFragment Android OH editor library.
- opening-hours-evaluator Library to check if opening_hours are open at a certain time, uses OpeningHoursParser for parsing
PHP
- código PHP code em SVN para analisar horários de funcionamento.
- Services_Openstreetmap, um pacote PEAR PHP para trabalhar com a API do OSM, suporta análise de várias sintaxes de horários de funcionamento - com exemplos aqui.
Renderização
No caso de 4/7 pode ser algo como adicionar um 24 ao ícone do objeto.
Os restantes valores não têm renderização óbvia.
- Mapas que mostram horários de abertura:
Etiquetas semelhantes
- opening_hours:office=*
- opening_hours:kitchen=*
- opening_hours:reception=*
- opening_hours:workshop=*
- opening_hours:atm=*
- opening_hours:drive_through=*
- opening_hours:covid19=*
- collection_times=*
- service_times=*
- smoking_hours=*
- happy_hours=*
Etiquetas obsoletas
As seguintes chaves (não documentadas) tornaram-se obsoletas e devem ser substituídas por esta chave opening_hours=*. Os seus valores devem ser interpretados para determinar o valor da nova chave:
Ver também Restrições condicionais.
Ver também
- Openingh.openstreetmap.de - ferramenta para analisar etiquetas opening_hours
- JOSM/Plugins/OpeningHoursEditor - um editor gráfico para a etiqueta opening_hours
- YoHours - Editor online para a sintaxe
- Conditional restrictions - uso da sintaxe de opening_hours para condições baseadas em tempo
- Pesquisas Sophox relevantes: