https://github.com/objectionary/eo-time

EO Objects for Date and Time Parsing and Printing
https://github.com/objectionary/eo-time

datetime eolang oop

Last synced: 11 days ago
JSON representation

EO Objects for Date and Time Parsing and Printing

• Host: GitHub
• URL: https://github.com/objectionary/eo-time
• Owner: objectionary
• Created: 2022-07-03T16:52:08.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-06-02T20:40:51.000Z (8 months ago)
• Last Synced: 2024-11-12T12:20:56.496Z (2 months ago)
• Topics: datetime, eolang, oop
• Homepage:
• Size: 5.86 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


[![EO principles respected here](https://www.elegantobjects.org/badge.svg)](https://www.elegantobjects.org)

[![DevOps By Rultor.com](http://www.rultor.com/b/objectionary/eo-time)](http://www.rultor.com/p/objectionary/eo-time)

[![We recommend IntelliJ IDEA](https://www.elegantobjects.org/intellij-idea.svg)](https://www.jetbrains.com/idea/)

[![Hits-of-Code](https://hitsofcode.com/github/objectionary/eo-time)](https://hitsofcode.com/view/github/objectionary/eo-time)

![Lines of code](https://img.shields.io/tokei/lines/github/objectionary/eo-time)

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/objectionary/eo-time/blob/master/LICENSE.txt)

[EO](https://www.eolang.org) objects for date/time manipulations.

To get current time:

```

QQ.dt.now > t

```

To make time from absolute value in **nano-seconds** after Epoch:

```

QQ.dt.time > t

  1656855443000000

```

To make short time interval:

```

QQ.dt.nanosecond.mul 10 > ten-ns

QQ.dt.microsecond.mul 50 > fifty-mcs

QQ.dt.millisecond.mul 100 > hundred-ms

QQ.dt.second.mul 3 > three-seconds

QQ.dt.minute.mul 4 > four-minutes

QQ.dt.hour.mul 5 > five-hours

QQ.dt.day > one-day

QQ.dt.week.mul 2 > two-weeks

```

To print it in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format

using [strftime](https://man7.org/linux/man-pages/man3/strftime.3.html):

```

QQ.io.stdout

  QQ.txt.sprintf

    "Current time is %s"

    QQ.dt.strftime

      "%Y-%m-%dT%H:%M:%S%z"

      t

```

To parse [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) back to time

using [strptime](https://man7.org/linux/man-pages/man3/strptime.3.html):

```

QQ.dt.strptime > t

  "%Y-%m-%dT%H:%M:%S%z"

  "2022-07-03T20:26:09+0300"

```

The object `QQ.dt.time` has the following attributes:

  * `plus` adds two times

  * `minus` subtracts

  * `eq` compares

  * `gt` is TRUE if greater than

  * `gte` if greater than or equal

  * `lt` if less than

  * `lte` if less than or equal

For example, to add five hours and thirty minutes to the current time and then compare it with the time of file creation:

```

QQ.io.stdout

  if.

    gt.

      plus.

        QQ.dt.now

        QQ.dt.hour.mul 5

        QQ.dt.minute.mul 30

      utime.

        QQ.fs.file

          "test.txt"

    "The file is too old"

    "The file is fresh"

```

There are two objects that are aware of calendar specifics and must be

used on the left side of the equation in order to respect the calendar. The following

code will move current time three months ahead:

```

plus

  QQ.dt.month.mul 3

  QQ.dt.now

```

## How to Contribute

Fork repository, make changes, send us a pull request.

We will review your changes and apply them to the `master` branch shortly,

provided they don't violate our quality standards. To avoid frustration,

before sending us your pull request please run full Maven build:

```bash

$ mvn clean install -Pqulice

```

You will need Maven 3.3+ and Java 8+.