Metadata-Version: 2.4
Name: ovos-skill-date-time
Version: 1.3.0a2
Summary: ovos date and time skill
Author-email: OpenVoiceOS <jarbasai@mailfence.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/OpenVoiceOS/ovos-skill-date-time
Keywords: ovos,skill,plugin
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: pytz>=2025.2
Requires-Dist: tzlocal>=5.3.1
Requires-Dist: timezonefinder>=6.5.9
Requires-Dist: geocoder~=1.38
Requires-Dist: ovos-utils>=0.8.1
Requires-Dist: ovos-workshop<10.0.0,>=0.0.16
Requires-Dist: ovos-date-parser<1.0.0,>=0.0.1
Requires-Dist: ovos-utterance-normalizer<1.0.0,>=0.0.1
Provides-Extra: test
Requires-Dist: ovoscope<2.0.0,>=1.5.0; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-json-report; extra == "test"
Requires-Dist: padacioso>=0.1.1; extra == "test"
Requires-Dist: tomli; python_version < "3.11" and extra == "test"
Dynamic: license-file

# <img src='https://raw.githack.com/FortAwesome/Font-Awesome/master/svgs/solid/calendar.svg' card_color='#22a7f0' width='50' height='50' style='vertical-align:bottom'/> Date and Time

Get the time, date, and day of the week.

## About

This skill gets the local time or the time in major cities around the world. It gives times in 12-hour format (2:30 pm) or 24-hour format (14:30), based on the Time Format setting in your `mycroft.conf`.

## Examples

* "What time is it?"
* "What time is it in Paris?"
* "Show me the time"
* "What day is it"
* "What's the date?"
* "Tell me the day of the week"
* "How many days until July 4th"
* "What day is Memorial Day 2020?"

## Configuration

You can adjust the skill's behavior in the `settings.json` file.

The skill includes 2 sound files, `"casio-watch.wav"` and `"clock-chime.mp3"`, to signal when the hour changes.

Below is an example configuration file with explanations for each option.

```json
{
    "play_hour_chime": true,
    "hour_sound": "clock-chime.mp3"
}
```

- **`play_hour_chime`**: (boolean) Turns the hourly chime on or off. If `true`, the skill plays an audio chime at the start of every hour. The default is `false`.
- **`hour_sound`**: (string) Sets the path to the audio file for the hourly chime. By default, it points to `casio-watch.wav` in the `res` folder. You can set it to the path of any audio file you prefer.

## Related projects

- [OpenVoiceOS/ovos-date-parser](https://github.com/OpenVoiceOS/ovos-date-parser): parses and formats dates and times for this skill.
- [OpenVoiceOS/ovos-workshop](https://github.com/OpenVoiceOS/ovos-workshop): the skill framework this skill builds on.
- [OpenVoiceOS/ovos-utterance-normalizer](https://github.com/OpenVoiceOS/ovos-utterance-normalizer): normalizes utterances before intent matching.

## Credits

- [casio-watch.wav by @Pablobd](https://freesound.org/people/Pablobd/sounds/492481/) under the [CC0 1.0 Universal License](https://creativecommons.org/publicdomain/zero/1.0/)
- [clock-chime.mp3 by @ecfike](https://pixabay.com/sound-effects/clock-chime-88027/) under the [Pixabay Content License](https://pixabay.com/service/license-summary/)
- Original skill by Mycroft AI (@MycroftAI)
- Timezone boundaries from [timezonefinder-data](https://github.com/jannikmi/timezonefinder), built from [timezone-boundary-builder](https://github.com/evansiroky/timezone-boundary-builder) on [OpenStreetMap](https://www.openstreetmap.org/copyright) data, under the [Open Database License (ODbL) v1.0](https://opendatacommons.org/licenses/odbl/1-0/)

Resolving a timezone from coordinates queries that database through the
`timezonefinder` package, which installs it unmodified. The ODbL asks for the
attribution above, and its share-alike clause covers a derivative of the
database: anyone who alters the bundled boundary data and passes it on must
offer the altered database under the ODbL as well. Using the skill, and
building on the skill's own Apache-2.0 code, carries no such obligation.

## Category
**Daily**

## Tags
#date
#time
#clock
#world-time
#world-clock
#date-time
