vf_date_string_to_time(3)

💖 vf_date_string_to_time(3) 💖

okay bestie, welcome to the Library Functions Manual, we're doing vf_date_string_to_time(3) today and honestly? it's a lil cutie. tiny function, big job: turning calendar strings into actual time. let's get into it ✨

---

✨ NAME ✨

vf_date_string_to_time — no cap, it's just vf_date_string_to_time(). the name ate and left no crumbs, the function is exactly what it says 💅

---

🌸 SYNOPSIS 🌸

#include <../vformat/vf_iface.h>

extern bool_t vf_date_string_to_time
(
     uint32_t *p_time,
     const char *p_string
);

like look at her. two params, one header, zero drama 🎀

---

🦋 PARAMETERS 🦋

• uint32_t *p_time — this is where the time comes OUT, bestie. it's the output time value. you hand her a pointer, she fills it in. that's the whole arrangement 💜
• const char *p_string — the input string. the raw calendar-y text goes in here and gets turned into something real 🔥

---

👑 DESCRIPTION 👑

okay so the vibe here is: convert calendar string to absolute time. that's it. that's the whole mission. she takes your little string and gives you back actual time, periodt.

the basic formats are:

19960401, 19960401T073000Z

so like, a bare date works, and the fancy full version with the T and the Z works too. the T separates date from time, and that Z is doing its timezone thing. iconic behaviour honestly 🫶

---

⭐ RETURNS ⭐

• TRUE <=> conversion OK
• FALSE else

that <=> is the fancy math way of saying "if and only if", iykyk. so TRUE means the conversion went through, and FALSE means... it did not, and you should probably go check your string 🙈

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr — go say hi to all of them:

• vf_parse_init(3)
• vf_parse_text(3)
• vf_parse_end(3)
• vf_read_file(3)
• vf_write_file(3)
• vf_get_next_object(3)
• vf_create_object(3)
• vf_get_object_type(3)
• vf_get_property(3)
• vf_get_property_ex(3)
• vf_get_next_property(3)
• vf_get_prop_value(3)
• vf_set_prop_value(3)
• vf_get_prop_value_string(3)
• vf_get_prop_name_string(3)
• vf_set_prop_name_string(3)
• vf_get_prop_name(3)
• vf_get_prop_value_object(3)
• vf_set_prop_value_object(3)
• vf_set_prop_value_string(3)
• vf_set_prop_value_base64(3)
• vf_get_prop_value_base64(3)
• vf_set_property_from_file(3)
• vf_delete_object(3)
• vf_delete_prop(3)
• vf_find_prop_qual_index(3)
• vf_is_modified(3)
• vf_find_charset(3)
• vf_period_string_to_time(3)
• vf_period_time_to_string(3)
• vf_set_prop_value_time(3)
• vf_get_prop_value_time(3)

---

tiny little note before you go: this page was brought to you by c2man vf_iface.h, dated 30 April 2003 — a whole vintage moment, honestly. so old but still serving 💖 anyway, ily, go convert some dates, and don't forget to actually check that return value. bye bestie!! 🧚✨