KDK_SYSTEM_GET_NOW_TIME_FORMAT(3)

📦 version 3.0.1.4, in arch rolling, ubuntu resolute, ubuntu stonking

💖 KDK_SYSTEM..._TIMEFORMAT(3) 💖

okay bestie, sit down, hydrate, because we're doing a Library Functions Manual deep-dive and honestly? this one's a little gem. no cap.

✨ NAME ✨

kdk_system_get_now_timeformat — 获取当前的时间格式

(that's "get the current time format" for my monolingual girlies 🫶 — but the original wording stays, periodt.)

🌸 SYNOPSIS 🌸

#include <libkydate.h>

extern char* kdk_system_get_now_timeformat();

Link with -lkydate.

so you're gonna #include <libkydate.h>, you're gonna declare extern char* kdk_system_get_now_timeformat();, and then — this is the part people forget and then cry about — you link with -lkydate. don't skip it. the linker will simply not know her. 💀

🦋 Detailed Description 🦋

the whole main character job of this interface is to set the time format of the system. that's the vibe. that's the assignment. ✨

🎀 RETURN VALUE 🎀

  • on success it hands you the current time format, typed as char* — and listen, the returned string needs to be released by free. it's yours now, you're responsible for it, take it to college. 🎓
  • on error, it returns NULL. sad girl hours. 😭

🧚 EXAMPLES 🧚

here's the whole thing, character for character, because I would never edit art:

#include "libkydate.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <stdlib.h>
#include <glib.h>
#include <glib-object.h>

int main()
{
     int ret = kdk_system_set_long_dateformat("2230年3月4日");
     ret = kdk_system_set_short_dateformat("22/5/3");

     char *ld = kdk_system_get_longformat_date();
     printf("long res = %s0, ld);
     free(ld);

     char *sd = kdk_system_get_shortformat_date();
     printf("short res = %s0, sd);
     free(sd);

     char *ll = kdk_system_get_longformat();
     printf("longformat = %s0, ll);
     free(ll);

     char *ss = kdk_system_get_shortformat();
     printf("shortformat = %s0, ss);
     free(ss);

     struct tm ptr;

     ptr.tm_year = 2322;
     ptr.tm_mon = 9;
     ptr.tm_mday = 3;

     char *lt = kdk_system_longformat_transform(&ptr);
     printf("longformat_transform = %s0, lt);
     free(lt);

     ptr.tm_year = 2022;
     ptr.tm_mon = 3;
     ptr.tm_mday = 2;

     char *st = kdk_system_shortformat_transform(&ptr);
     printf("shortformat_transform = %s0, st);
     free(st);

     kdk_logn_dateinfo *info = kdk_system_login_lock_dateinfo("szm");
     printf("date = %s,time = %s,week = %s0,info->date,info->time,info->week);
     kdk_free_logn_dateinfo(info);

     ptr.tm_hour = 19;
     ptr.tm_min = 3;
     ptr.tm_sec = 2;
     kdk_timeinfo *ti = kdk_system_timeformat_transform(&ptr);
     printf("time = %s, timesec = %s0, ti->time, ti->timesec);
     kdk_free_timeinfo(ti);

    return 0;
}
👀 yes, I copied it exactly as it lives in the original, %s0 and all. not my job to fix it, my job is to love it.

notice how every get gets a matching free? that's the self-care routine. you get a string, you free a string. balance. 🧘‍♀️

👑 CONFORMING TO 👑

these functions are as per the withdrawn POSIX.1e draft specification. withdrawn, bestie. retired. living her best retired life. 🏖️

the following functions are Linux extensions — here's the full roll call, no one gets left out of the group photo:

  • kdk_system_get_dateformat()
  • kdk_system_set_dateformat()
  • kdk_system_set_24_timeformat()
  • kdk_system_set_12_timeformat()
  • kdk_system_get_now_dateformat()
  • kdk_system_tran_dateformat()
  • kdk_system_nowtime()
  • kdk_system_nowdate()
  • kdk_system_shortweek()
  • kdk_system_longweek()
  • kdk_system_second()
  • kdk_system_logn_dateinfo()
  • kdk_system_gjx_time()
  • kdk_date_freeall()
  • kdk_free_dateinfo()
  • kdk_free_logn_dateinfo()
  • kdk_system_set_long_dateformat()
  • kdk_system_set_short_dateformat()
  • kdk_system_get_longformat_date()
  • kdk_system_get_shortformat_date()
  • kdk_system_get_longformat()
  • kdk_system_get_shortformat()
  • kdk_system_longformat_transform()
  • kdk_system_shortformat_transform()
  • kdk_system_login_lock_dateinfo()
  • kdk_system_timeformat_transform()
  • kdk_free_timeinfo()

🌈 SEE ALSO 🌈

the whole squad, go read them too, they're all serving:

💅 vibe check: if you call her, you free her. that's the rule. that's the whole rule.

and that's the page, bestie!! this one came out of the Linux Programmer's Manual, dated Tue Sep 19 2023, filed under KDK_SYSTEM..._TIMEFORMAT(3). go forth, format your time, free your strings, and stan responsibly. 🫶✨🎀🦋

📦 where this page comes from