BUILD_TIME is a procedural macro. It will run at compile time and transform your program's source code.

Adding `build-time` macro(s) as a dependency

Run this command in a terminal, in your project's directory:

cargo add build-time

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

build-time = "0.1.3"

You may need to import the macro(s) with use build_time::*.

Read the build_time documentation.

Back to the crate overview.

Readme

build-time

Simple proc-macros to generate build timestamp string literals.

Based on Jasen Borisov's build_timestamp crate.

Two function like procedures are provided: build_time_utc and build_time_local.

They take an optional strftime date and time format string as input, and return a string literal. If the input is empty, they will return a string literal in RFC 3339 date and time format, e.g., "2021-05-29T06:55:50.418437046+00:00".

Requires Rust 1.45+ because these macros are used in expression positions.

Usage

use build_time::{build_time_utc, build_time_local};

// Returns the UTC build timestamp in RFC3339 date and time format.
let utc_build_time = build_time_utc!();

// Returns the local build timestamp in the specified format.
let local_build_time = build_time_local!("%Y-%m-%dT%H:%M:%S%.f%:z");

Adding build-time macro(s) as a dependency

Adding `build-time` macro(s) as a dependency