KDK_SYSTEM_GET_DATEFORMAT(3)

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

💖 KDK_SYSTEM_GET_DATEFORMAT 💖

okay so bestie, welcome to the Library Functions Manual corner of the internet, where today's main character is KDK_SYSTEM..._DATEFORMAT(3) 💅 she's a little date-format getter and she is serving.

✨ NAME ✨

  • kdk_system_get_dateformat — 获取系统支持的日期格式 (that's "get the date format(s) the system supports", for my monolingual girlies 🫶)

📜 SYNOPSIS 📜

#include <libkydate.h>

extern char** kdk_system_get_dateformat();

and bestie, don't forget to link with -lkydate or it will simply not vibe with you. ✨

🌸 Detailed Description 🌸

The main function of this interface is to obtain the date format supported by the system. that's it. that's the whole job. lowkey iconic of her honestly. 👑

🔥 RETURN VALUE 🔥

  • On success, she hands you a list of supported date formats with type char **, ending with a NULL string. it's Generated by alloc — so it needs to be recycled by kdk_date_freeall. yes bestie, you have to free it, this is not a take-what-you-want-and-leave situation, it's giving memory management 🧚
  • On error, return NULL. that's it. no list, no vibes, just NULL. 😭
not me reminding you again: free it with kdk_date_freeall or you're leaking, and leaking is NOT cute. 🚨

💅 EXAMPLES 💅

here's the whole thing, copied exactly as it lives, typos and all — I do not edit the source material, I respect her too much:

#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;
}

that's the whole example, verbatim, no cap. 💯

👑 CONFORMING TO 👑

These functions are as per the withdrawn POSIX.1e draft specification. and the following functions are Linux extensions, so don't go looking for them in your POSIX textbook bestie, she's not there:

  • kdk_system_set_dateformat()
  • kdk_system_set_24_timeformat()
  • kdk_system_set_12_timeformat()
  • kdk_system_get_now_dateformat()
  • kdk_system_get_now_timeformat()
  • 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 friend group, go say hi:

and that's the whole page bestie!! 🌈 this one came out of the Linux Programmer's Manual, stamped Tue Sep 19 2023, and yes she still answers to KDK_SYSTEM..._DATEFORMAT(3) 💖 now go free your allocations, love u, bye!! 🎀🦋✨

📦 where this page comes from