Warning, /libraries/kopeninghours/README.md is written in an unsupported language. File is not indexed.

0001 # KOpeningHours
0002 
0003 A library for parsing and evaluating OSM opening hours expressions.
0004 
0005 ## Introduction
0006 
0007 OSM opening hours expressions are used to describe when a feature is open/available or closed. This format
0008 is not only used in OpenStreetMap itself, but in various other data sources or APIs needing such a description
0009 as well.
0010 
0011 See:
0012 * https://wiki.openstreetmap.org/wiki/Key:opening_hours
0013 * https://wiki.openstreetmap.org/wiki/Key:opening_hours/specification
0014 
0015 ## Supported Features
0016 
0017 The parser and validator is fairly complete. However the evaluation feature has the following limitations.
0018 
0019 So far only the time interval mode is supported, not the point in time mode.
0020 
0021 Supported opening hours features are:
0022 * rule sequences
0023 * fallback rules
0024 * all rule modifiers and rule comments
0025 * time span, weekday, week, month, month day and year selectors
0026 * open-ended time spans
0027 * solar position based variable time events
0028 * public holiday selectors (based on KF5::Holidays)
0029 * variable date selectors
0030 
0031 Still missing features:
0032 * comment preservation on intersecting close rules
0033 * wide range selector placeholder comments
0034 * school holiday selectors
0035 * open ended month ranges
0036 
0037 ## Other Formats
0038 
0039 Opening hours in the schema.org format can be read as well, via KOpeningHours::OpeningHours::fromJsonLd().