KDK_SYSTEM_SET_DATEFORMAT(3)

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

💖 kdk_system_set_dateformat 💖

okay so bestie, pull up a chair, because this is a page from the Library Functions Manual (section 3, the library girlies ✨) and it's about the function kdk_system_set_dateformat. yes the title is literally KDK_SYSTEM..._DATEFORMAT(3) because even man page titles get truncated by the terminal and we just live with it 💅

✨ NAME ✨

kdk_system_set_dateformat — 设置日期格式 (that's "set the date format", she's bilingual, she's iconic 🎀)

🌸 SYNOPSIS 🌸

#include <libkydate.h>

extern int kdk_system_set_dateformat(char *date);

and like, you gotta link it:

-lkydate

🦋 Detailed Description 🦋

so the main character job of this interface is to set the date format of the system. that's it. that's the whole vibe. 👑

the argument date is the date format. and if you're sitting there like "bestie what format tho 😭" — the manpage says: please refer to the return value of kdk_system_get_format for the specific format. so go read that one, iykyk. 🫶

💜 RETURN VALUE 💜

  • On success, returns 1 ✨ (slay)
  • On error, return -1 💀 (not slay)

🍓 EXAMPLES 🍓

here's the whole example, verbatim, no notes, we don't gatekeep:

#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;
}
okay so real talk bestie, the example is copied here exactly as it is on the page — including the <stdlib.h> that shows up twice and those printf lines that look a lil unhinged with the %s0 and the missing closing quote. we do NOT fix it. we do NOT "help". we reproduce it fr fr. copy-paste at your own risk 😭

🌈 CONFORMING TO 🌈

these functions are as per the withdrawn POSIX.1e draft specification. (withdrawn! vintage! it's giving antique 🏺)

and the following functions are Linux extensions:

  • 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_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()
  • and kdk_free_timeinfo()

🎀 SEE ALSO 🎀

go read her sisters, they're all icons:

and that's the whole page, bestie. mwah. 💋

this cutie came from the Linux Programmer's Manual, dated Tue Sep 19 2023, and her official little signature at the bottom is KDK_SYSTEM..._DATEFORMAT(3). ok bye ily, go set a date format 🦋✨💖

📦 where this page comes from