README.md

June 4, 2026 ยท View on GitHub

Zig-time

A date and time parse and format library for Zig.

Env

  • Zig >= 0.16.0

Adding zig-time as a dependency

Add the dependency to your project:

zig fetch --save=zig-time git+https://github.com/deatil/zig-time#main

or use local path to add dependency at build.zig.zon file

.{
    .dependencies = .{
        .@"zig-time" = .{
            .path = "./lib/zig-time",
        },
        ...
    },
    ...
}

And the following to your build.zig file:

const zig_time_dep = b.dependency("zig-time", .{});
exe.root_module.addImport("zig-time", zig_time_dep.module("zig-time"));

The zig-time structure can be imported in your application with:

const zig_time = @import("zig-time");

Get Starting

const std = @import("std");
const time = @import("zig-time");

pub fn main(init: std.process.Init) !void {
    const io = init.io;

    const time_0 = time.now(io).timestamp();
    std.debug.print("now time: {d} \n", .{time_0});
    
    // ==========
    
    const seed: i64 = 1691879007;
    const fmt: []const u8 = "YYYY-MM-DD HH:mm:ss z";
    
    const alloc = std.heap.page_allocator;
    const instant = time.Time.fromTimestamp(seed).setLoc(time.UTC);
    const fmtRes = try instant.formatAlloc(alloc, fmt);
    defer alloc.free(fmtRes);
    
    // output: 
    // format time: 2023-08-12 22:23:27 UTC
    std.debug.print("format time: {s} \n", .{fmtRes});
}

LICENSE

  • The library LICENSE is Apache2, using the library need keep the LICENSE.