DC_DATETIME_LOCALTIME(3)

📦 version 0.9.0, in nixos 26.05, nixpkgs unstable

✨ DC_DATETIME_LOCALTIME(3) ✨

okay so bestie, this one's from the Library Functions Manual (that's the manual name, cute right?) and it's literally gonna turn your timestamp into local time 💅

🌸 NAME 🌸

dc_datetime_localtime — convert an timestamp to local date and time

(yes, "an timestamp", the original said it like that, we're keeping it, it's iconic 😭)

🎀 LIBRARY 🎀

library “libdivecomputer” 🫶

🦋 SYNOPSIS 🦋

#include <libdivecomputer/datetime.h>

dc_datetime_t *
dc_datetime_localtime(dc_datetime_t *result, dc_ticks_t ticks);

💖 DESCRIPTION 💖

So what this does is, it takes an integral timestamp ticks — one of those you made with dc_datetime_now(3) or dc_datetime_mktime(3) — and converts it into a broken-down local-time representation, and drops it right into result. slay. ✨

The filled-in value consists of the year, month, day, hour, minute, and second fields. that's the whole glow-up, no cap.

⚠️ Note, bestie, this is important: unlike in struct tm, the value for year is normalised, not less 1900. and moreover, the value for month is from one, not zero. so like, don't come at it with your struct tm assumptions, it's built different 💀

Also, lowkey, the dc_datetime_localtime function may internally invoke libc's localtime(3), or if available, localtime_r(3). iykyk 🧚

🔥 RETURN VALUES 🔥

This returns the result pointer on success — main character behavior 👑.

It returns NULL if ticks cannot be sanely converted, or if result is NULL. so like, vibe check your arguments, fr fr 🙈

🌈 SEE ALSO 🌈

the whole squad, go read 'em 💜

💅 AUTHORS 💅

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. and the manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. absolute icons, both of them 🎀⭐

💫 and that's the tea, bestie! this page came to you via Debian, dated January 11, 2017, and it's filed under DC_DATETIME_LOCALTIME(3) — go forth and convert those timestamps 💫

📦 where this page comes from