SDL_TimeToDateTime(3)

✨ SDL_TimeToDateTime ✨

okay bestie, welcome to the SDL_TimeToDateTime(3) page, part of the SDL3 FUNCTIONS lineup 💖 this one's a certified bop, let's get into it.

---

🌸 NAME 🌸

SDL_TimeToDateTime — converts an SDL_Time in nanoseconds since the epoch into a calendar time in the SDL_DateTime format. it's giving timezone glow-up, fr fr 🕰️✨

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_time.h>

bool SDL_TimeToDateTime(SDL_Time ticks, SDL_DateTime *dt, bool localTime);

---

💅 FUNCTION PARAMETERS 💅

• ticks — the SDL_Time you want converted. that's the raw number, the vibes in nanoseconds, the whole point of the operation 🫶
• dt — the resulting SDL_DateTime. this is where the calendar-y goodness lands, so make sure it's pointing somewhere real, okay? no cap.
• localTime — if it's true, the resulting SDL_DateTime gets expressed in local time. if it's false, you get it in Universal Coordinated Time (UTC) instead. pick your fighter 🌍 vs 🏠

---

⭐ RETURN VALUE ⭐

returns true on success, or false on failure 😭 and if it fails, you call SDL_GetError() for more info. always check, bestie, don't just assume it ate 💀

---

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. go wild, queen 👑 no locks, no stress, no drama.

---

🌈 AVAILABILITY 🌈

this function has been available since SDL 3.2.0. so if you're on something older, sorry babe, it's not there 🙈

---

and that's the whole page, you ate that 🍓 mwah 💋

this lil rewrite came to you courtesy of Simple Directmedia Layer, sitting pretty at SDL 3.4.18, and yeah it's still the SDL_TimeToDateTime(3) page — same icon, new energy. bye bestie, go convert some timestamps 💜🦋