LIBKYDATE(3)

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

💖 LIBKYDATE(3) — the girlies' guide to date & time formats 💖

okay so bestie, this is a Library Functions Manual page for libkydate — it's the lib that obtains or sets date and time formats ✨. Literally the whole thing is 日期和时间格式信息 energy. Buckle up 🎀

🌸 NAME 🌸

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, kdk_free_timeinfo — 日期和时间格式信息

like yes, that is a LOT of names, they're all one big friend group 💅

✨ SYNOPSIS ✨

#include <libkydate.h>

extern char** kdk_system_get_dateformat();

extern int kdk_system_set_dateformat(char *date);

extern int kdk_system_set_24_timeformat();

extern int kdk_system_set_12_timeformat();

extern char* kdk_system_get_now_dateformat();

extern char* kdk_system_get_now_timeformat();

extern kdk_dateinfo *kdk_system_tran_dateformat(struct tm *ptr);

extern char* kdk_system_nowtime();

extern char* kdk_system_nowdate();

extern char* kdk_system_shortweek();

extern char* kdk_system_longweek();

extern char* kdk_system_second();

extern kdk_logn_dateinfo *kdk_system_logn_dateinfo(char *user);

extern char* kdk_system_gjx_time(char *date);

extern inline void kdk_date_freeall(char **ptr);

extern void kdk_free_dateinfo(kdk_dateinfo *date);

extern void kdk_free_logn_dateinfo(kdk_logn_dateinfo *date);

extern int kdk_system_set_long_dateformat(char *format);

extern int kdk_system_set_short_dateformat(char *format);

extern char* kdk_system_get_longformat_date();

extern char* kdk_system_get_shortformat_date();

extern char* kdk_system_get_longformat();

extern char* kdk_system_get_shortformat();

extern char* kdk_system_longformat_transform(struct tm *ptr);

extern char* kdk_system_shortformat_transform(struct tm *ptr);

extern kdk_logn_dateinfo *kdk_system_login_lock_dateinfo(char *user);

extern kdk_timeinfo *kdk_system_timeformat_transform(struct tm *ptr);

extern void kdk_free_timeinfo(kdk_timeinfo *time);

Link with -lkydate. that's the vibe check you need to pass, no cap 🔗

🦋 DATA STRUCTURES 🦋

🎀 Structure kdk_dateinfo

bestie this one holds info related to a date:

typedef struct _kdk_dateinfo{ {
     char *date;     // 日期
    char *time;   // 时间
    char *timesec;  //带秒钟数时间
}kdk_dateinfo;
ok so there are other members not documented here, and they're only meant for libkydate internal use 🙈 don't touch, that's their business, periodt.

🌷 Structure kdk_logn_dateinfo

this cutie holds info related to a login date:

typedef struct _kdk_logn_dateinfo {
     char *date;     // 日期
    char *time;   // 时间
    char *week;
}kdk_logn_dateinfo;
again — other members exist that aren't documented here, and they're only meant for libkydate internal use 💅 stay out of it.

🌈 Structure kdk_timeinfo

and this one is all about a time:

typedef struct _kdk_timeinfo {
     char *time;   // 时间
    char *timesec;  //带秒钟数时间
}kdk_timeinfo;
same deal: other members are undocumented and only meant for libkynetinfo internal use 😭 (yes it says libkynetinfo, that's what the page says, not me, I don't make the rules).

👑 Detailed Description 👑

okay the TL;DR: this library obtains or sets date and time formats. that's the whole mission statement bestie ✨

💀 RETURN VALUE 💀

ngl the return value is generally specific to the individual function called — so like, check the individual function, iykyk 🫶

⭐ CONFORMING TO ⭐

these functions are as per the withdrawn POSIX.1e draft specification 😭 (withdrawn!! rip bozo).

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

💜 SEE ALSO 💜

go read the whole squad's individual pages, they each got their own:

and that's the whole page bestie 🫶 mwah 💋

sign-off szn: this one came out of the Linux Programmer's Manual, dated Tue Sep 19 2023, and its manual name is LIBKYDATE(3) — so when you're searching for it, that's the tag, okurrr? 💅✨🌸

📦 where this page comes from