https://github.com/frmdstryr/zig-datetime

A date and time module for Zig
https://github.com/frmdstryr/zig-datetime

zig

Last synced: 3 months ago
JSON representation

A date and time module for Zig

• Host: GitHub
• URL: https://github.com/frmdstryr/zig-datetime
• Owner: frmdstryr
• License: mit
• Created: 2019-12-19T17:15:38.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-04-06T19:59:23.000Z (10 months ago)
• Last Synced: 2025-04-13T05:44:58.122Z (10 months ago)
• Topics: zig
• Language: Zig
• Homepage:
• Size: 93.8 KB
• Stars: 95
• Watchers: 5
• Forks: 16
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zig - zig-datetime🗒️A date and time module for Zig
• awesome-zig - frmdstryr/zig-datetime - A datetime module for Zig with an api similar to python's Arrow. (Date, Time and Timezones / Linker)

README

          
# Zig Datetime

[![actions](https://github.com/frmdstryr/zig-datetime/actions/workflows/ci.yml/badge.svg)](https://github.com/frmdstryr/zig-datetime/actions)

[![codecov](https://codecov.io/gh/frmdstryr/zig-datetime/branch/master/graph/badge.svg)](https://codecov.io/gh/frmdstryr/zig-datetime)

A datetime module for Zig with an api similar to python's Arrow.

> [!NOTE]

> DST is now implemeted to the library. Some timezones that relying on islamic calendar for DST might not work yet. It is also possible that we might have skipped some timezones by mistake because there are a lot of timezones.

> [!IMPORTANT]

> With DST implementation, the `shiftTimezone` method changed and now taking timezone argument passed by value contrary to before that it was passed by pointer.

## Install

1) Add zig-datetime as a dependency in your `build.zig.zon`:

```bash

zig fetch --save git+https://github.com/frmdstryr/zig-datetime#master

```

2) In your `build.zig`, add the `datetime` module as a dependency you your program:

```zig

const pg = b.dependency("datetime", .{

    .target = target,

    .optimize = optimize,

});

// the executable from your call to exe_mod.addExecutable

exe.root_module.addImport("datetime", pg.module("datetime"));

```

## Example

```zig

const allocator = std.heap.page_allocator;

const date = try Date.create(2019, 12, 25);

const next_year = date.shiftDays(7);

assert(next_year.year == 2020);

assert(next_year.month == 1);

assert(next_year.day == 1);

// In UTC

const now = Datetime.now();

const now_str = try now.formatHttp(allocator);

defer allocator.free(now_str);

std.debug.warn("The time is now: {}\n", .{now_str});

// The time is now: Fri, 20 Dec 2019 22:03:02 UTC

```