GI.Soup.Structs.Date

A date and time. The date is assumed to be in the (proleptic) Gregorian calendar. The time is in UTC if utc is True. Otherwise, the time is a local time, and offset gives the offset from UTC in minutes (such that adding offset to the time would give the correct UTC time). If utc is False and offset is 0, then the SoupDate represents a "floating" time with no associated timezone information.

Exported types

newtype Date

Constructors

Date (ManagedPtr Date)

Instances

BoxedObject Date

Methods

boxedType :: Date -> IO GType

(~) AttrOpTag tag AttrSet => Constructible Date tag

Methods

new :: MonadIO m => (ManagedPtr Date -> Date) -> [AttrOp Date tag] -> m Date

newZeroDate :: MonadIO m => m Date

Construct a Date struct initialized to zero.

noDate :: Maybe Date

Methods

copy

dateCopy

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Date

Copies date.

Since: 2.24

free

dateFree

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m ()

Frees date.

Since: 2.24

getDay

dateGetDay

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's day

Gets date's day.

Since: 2.32

getHour

dateGetHour

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's hour

Gets date's hour.

Since: 2.32

getMinute

dateGetMinute

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's minute

Gets date's minute.

Since: 2.32

getMonth

dateGetMonth

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's month

Gets date's month.

Since: 2.32

getOffset

dateGetOffset

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's offset from UTC. If dateGetUtc returns False but dateGetOffset returns 0, that means the date is a "floating" time with no associated offset information.

Gets date's offset from UTC.

Since: 2.32

getSecond

dateGetSecond

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's second

Gets date's second.

Since: 2.32

getUtc

dateGetUtc

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: True if date is UTC.

Gets date's UTC flag

Since: 2.32

getYear

dateGetYear

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Int32

Returns: date's year

Gets date's year.

Since: 2.32

isPast

dateIsPast

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m Bool

Returns: True if date is in the past

Determines if date is in the past.

Since: 2.24

new

dateNew

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

year: the year (1-9999)

-> Int32

month: the month (1-12)

-> Int32

day: the day of the month (1-31, as appropriate for month)

-> Int32

hour: the hour (0-23)

-> Int32

minute: the minute (0-59)

-> Int32

second: the second (0-59, or up to 61 for leap seconds)

-> m Date

Returns: a new Date

Creates a Date representing the indicated time, UTC.

newFromNow

dateNewFromNow

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

offsetSeconds: offset from current time

-> m Date

Returns: a new Date

Creates a Date representing a time offsetSeconds after the current time (or before it, if offsetSeconds is negative). If offset_seconds is 0, returns the current time.

If offsetSeconds would indicate a time not expressible as a <type>time_t</type>, the return value will be clamped into range.

newFromString

dateNewFromString

Arguments

:: (HasCallStack, MonadIO m)

=> Text

dateString: the date in some plausible format

-> m (Maybe Date)

Returns: a new Date, or Nothing if dateString could not be parsed.

Parses dateString and tries to extract a date from it. This recognizes all of the "HTTP-date" formats from RFC 2616, all ISO 8601 formats containing both a time and a date, RFC 2822 dates, and reasonable approximations thereof. (Eg, it is lenient about whitespace, leading "0"s, etc.)

newFromTimeT

dateNewFromTimeT

Arguments

:: (HasCallStack, MonadIO m)

=> CLong

when: a <type>time_t</type>

-> m Date

Returns: a new Date

Creates a Date corresponding to when

toString

dateToString

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> DateFormat

format: the format to generate the date in

-> m Text

Returns: date as a string

Converts date to a string in the format described by format.

toTimeT

dateToTimeT

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m CLong

Returns: date as a <type>time_t</type>

Converts date to a <type>time_t</type>.

If date is not representable as a <type>time_t</type>, it will be clamped into range. (In particular, some HTTP cookies have expiration dates after "Y2.038k" (2038-01-19T03:14:07Z).)

toTimeval

dateToTimeval

Arguments

:: (HasCallStack, MonadIO m)

=> Date

date: a Date

-> m TimeVal

Converts date to a TimeVal.

Since: 2.24

Properties

day

getDateDay :: MonadIO m => Date -> m Int32

setDateDay :: MonadIO m => Date -> Int32 -> m ()

hour

getDateHour :: MonadIO m => Date -> m Int32

setDateHour :: MonadIO m => Date -> Int32 -> m ()

minute

getDateMinute :: MonadIO m => Date -> m Int32

setDateMinute :: MonadIO m => Date -> Int32 -> m ()

month

getDateMonth :: MonadIO m => Date -> m Int32

setDateMonth :: MonadIO m => Date -> Int32 -> m ()

offset

getDateOffset :: MonadIO m => Date -> m Int32

setDateOffset :: MonadIO m => Date -> Int32 -> m ()

second

getDateSecond :: MonadIO m => Date -> m Int32

setDateSecond :: MonadIO m => Date -> Int32 -> m ()

utc

getDateUtc :: MonadIO m => Date -> m Bool

setDateUtc :: MonadIO m => Date -> Bool -> m ()

year

getDateYear :: MonadIO m => Date -> m Int32

setDateYear :: MonadIO m => Date -> Int32 -> m ()