https://github.com/formulae-org/package-time-js

Time package for Fōrmulæ, in JavaScript
https://github.com/formulae-org/package-time-js

daylight-saving-time epoch formulae gregorian-calendar javascript time time-formatting time-visualization timezone timezone-offset

Last synced: 6 months ago
JSON representation

Time package for Fōrmulæ, in JavaScript

• Host: GitHub
• URL: https://github.com/formulae-org/package-time-js
• Owner: formulae-org
• License: agpl-3.0
• Created: 2023-04-16T19:19:47.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-24T04:46:32.000Z (8 months ago)
• Last Synced: 2025-02-24T05:30:16.799Z (8 months ago)
• Topics: daylight-saving-time, epoch, formulae, gregorian-calendar, javascript, time, time-formatting, time-visualization, timezone, timezone-offset
• Language: JavaScript
• Homepage:
• Size: 71.3 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# package-time-js

Time package for the [Fōrmulæ](https://formulae.org) programming language.

Fōrmulæ is also a software framework for visualization, edition and manipulation of complex expressions, from many fields. The code for an specific field —i.e. arithmetics— is encapsulated in a single unit called a Fōrmulæ **package**.

This repository contains the source code for the **time package**. It is intended to the computation of expression related to time management under the gregorian calendar.

The GitHub organization [formulae-org](https://github.com/formulae-org) encompasses the source code for the rest of packages, as well as the [web application](https://github.com/formulae-org/formulae-js).

### Capabilities ###

* Time expressions with precision of a millisecond

* Friendly visualization of a time

* Interactive creation of time expressions including the time zone

* Programatic creation of time (in current or given time zone)

* Both interactive and programmatic creation of a time expression work in lenient parsing

* Retrieving a component of a time (in current or given time zone)

   * Year (BC as negatives)

   * Month as a symbol

   * Month as a number

   * Day of the month

   * Weekday

   * Hour of the day, in 24-hour format

   * Minute

   * Second

   * Millisecond

   * Time zone offset, in minutes. It always retrieves 0 if the current or given time zone does not observe dayling saving time

   * Whether or not the time is in daylight saving time. It always retrieves false if the current or given time zone does not observe dayling saving time

* Formatting a time expression (as a string)

    * In the current or given locale

    * In the current or given time zone

* Conversion from/to an integer number (the epoch)