gMonth

EXESS_MAX_MONTH_LENGTH

10U

The maximum length of a gMonth string from exess_write_month()

struct ExessMonth

Month in a Gregorian year.

uint8_t month

Month: [1, 12].

ExessTimezone zone

Timezone offset in quarter hours.

ExessResult exess_read_month(const char *str, ExessMonth *out)

Read a gMonth string after any leading whitespace.

Parameters:

  • str – String to read.

  • out – Parsed value, or zero on error.

Returns:

The count of characters read, and a status.

ExessResult exess_write_month(ExessMonth value, size_t buf_size, char *buf)

Write a canonical gMonth string.

The output is always in canonical form, like --04 or --04+03:00.

Parameters:

  • value – Value to write.

  • buf_size – Size of buf in bytes.

  • buf – Output buffer, or null to only measure.

Returns:

ExessStatus.EXESS_SUCCESS on success, ExessStatus.EXESS_NO_SPACE if the buffer is too small, or ExessStatus.EXESS_BAD_VALUE if the value is invalid.