SDL_GetDayOfYear(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GetDayOfYear 💖

okay so bestie, we're in the SDL3 FUNCTIONS section of the manual and this one is literally so useful — it's the lil function that tells you which day of the year a calendar date lands on. yes, the "wait, is March 3rd day 62 or day 63??" question, answered. no cap. ✨

🌸 NAME 🌸

SDL_GetDayOfYear — get the day of year for a calendar date. that's it, that's the whole vibe 🗓️💅

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_time.h>

int SDL_GetDayOfYear(int year, int month, int day);

🎀 FUNCTION PARAMETERS 🎀

three lil inputs, all of them your responsibility to get right, okay? 🫶

  • year — the year component of the date. the big number. the "20xx" part. 👑
  • month — the month component of the date. yes you have to actually pick one, it won't guess. 🍓
  • day — the day component of the date. the day-of-the-month day. not the day-of-year day. that's literally what we're computing. stay with me bestie 😭

⭐ RETURN VALUE ⭐

so here's the tea:

  • if the date is valid, you get the day of year back, and it's in the range [0-365] 🌈
  • if it's not valid, you get -1 💀 and that's your signal to call SDL_GetError() for more information.
fr fr, always check for that -1. it's giving "something went wrong" and you do NOT want to be out here treating -1 like a real day of the year. 🙈

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. go off, multithreaded queen. 👑✨

💜 AVAILABILITY 💜

this function is available since SDL 3.2.0. so if you're on something older... bestie. update. 😌

💖 ok that's the whole page!! written by Simple Directmedia Layer for SDL 3.4.18 — mwah, slay, go compute some days of the year, ily, bye!! 🎀🦋💅
📦 where this page comes from