KDK_SYSTEM_GET_SHORTFORMAT_DATE(3)

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

👑 KDK_SYSTEM_GET_SHORTFORMAT_DATE(3) 👑

okay bestie, welcome to the Library Functions Manual — yes that's the manual name, we're fancy here. this one's about kdk_system_get_shortformat_date, and it's genuinely so chill you're gonna be obsessed. it's giving "tiny function, big main character energy." let's go ✨

🌸 NAME 🌸

kdk_system_get_shortformat_date — 获取当前的短格式日期

(that's "get the current short format date" for my monolingual girlies 💖 the original said it in Chinese so we keep it in Chinese, no cap, facts are facts.)

🎀 SYNOPSIS 🎀

#include <libkydate.h>

extern char* kdk_system_get_shortformat_date();

Link with -lkydate.

so you pull in <libkydate.h>, you call the thing, and you link with -lkydate. that's the whole vibe. 🦋

💫 Detailed Description 💫

the main function of this interface is to obtain the current short format date. literally that's it. that's the job. it gets the date, short-format style, and hands it to you. lowkey iconic for how straightforward it is. 💅

✨ RETURN VALUE ✨

  • On success — returns the current short format date with type of char *. ⭐ and heads up bestie, the returned string needs to be released by free. you gotta free it. do not ghost it. do not leave it hanging. free it. 🫶
  • On error — returns NULL. that's your sign something went sideways. 🙈

🌈 EXAMPLES 🌈

here's the whole demo, exactly as it was written, character for character. copy-paste responsibly, queen 👑

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

notice how every single getter gets a matching free? that's the self-care routine. cleanse your memory, babe. 🧚

💜 CONFORMING TO 💜

these functions are as per the withdrawn POSIX.1e draft specification. yes, withdrawn — it's a vintage, bestie, we love a retro moment.

the following functions are Linux extensions, i.e. the bonus tracks on the album:

  • 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_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 these next, they're all in the same friend group:

okay that's the whole page, you ate it, you understood it, you're gonna go free your strings and live your truth. 💖

sign-off szn: this little masterpiece lives in the Linux Programmer's Manual, and it's dated Tue Sep 19 2023. remember the date, it's practically a birthday. bye bestie, slay your dates 🌸💅🦋

📦 where this page comes from