company logo

Date :: assign - Set date value

The function provides different ways for setting a date value.

Return value:  Date ( odaba::Date & )

The date contains day, month and year, but not the time.

Implementation overview

Implementation details

  1. Create an empty data value
    odaba::Date & Date  :: assign (  )

    The function initializes date to the current date.

  2. to list
  3. Copy date value
    odaba::Date & Date  :: assign ( odaba::Date &cDate )

    The function copies the date value passed in cDate .

    • cDate - Date

      The date contains day, month and year, but not the time.

  4. to list
  5. Set date from number of days
    odaba::Date & Date  :: assign ( int32 iDays )

    The function sets the date value to the date, which corresponds to the number of days since 1.1.1870.

    • iDays - Set date from days

      The function calculates the date from the number of days passed in iDays . The value must be greater than 0 .

  6. to list
  7. Create date value from day, month and year
    odaba::Date & Date  :: assign ( int32 iDay, int32 iMonth, int32 iYear )

    The function creates an ODABA date for the day, month and year passed in iDay , iMonth and iYear .

    • iDay - Day

      Day of the month according to the Gregorian Calendar.

    • iMonth - Month

      Month of the year according to the Gregorian Calendar.

    • iYear - Year

      Number of the year (AD).

  8. to list
  9. Set local date value from unix timestamp
    odaba::Date & Date  :: assign ( int64 iUnixTime, bool bLocalTime )

    The Unix timestamp, which is passed in iUnixTime , contains the number of seconds since 1.1.1970 0:00:00 (UTC). The U nix timestamp is supposed to contain a standard time value (UTC).

    When true has been passed in bLocalTime , the timestamp will be adjusted to local time before being converted into an ODABA date value ignoring the time in the timestamp value.

    When false has been passed in bLocalTime , the timestamp is supposed to contain standard time value (UTC) or the application is responsible for proper interpretation.

    • iUnixTime - Unix time stamp

      The unix timestamp contains the number of seconds since 1.1.1970 0:00:00 (UTC), which is an absolute timestamp that might be converted into local time.

    • bLocalTime - Local or standard time

      The option indicates, that a time value or timestamp contains local time ( true ) or Greenwich standard time ( false ).

  10. to list
  11. Set date value from string
    odaba::Date & Date  :: assign ( odaba::String &sDate )

    The function sets the date value from the string date passed in sDate . When no date format has been set, the date format is detected automatically from string value as follows:

    • contains '.' - DD.MM.YYYY or DD.MM.YY
    • contains '/' - MM/DD/YYYY or MM/DD/YY
    • contains '-' - YYYY-MM-DD or YY-MM-DD
    • else - YYYYMMDD or YYMMDD
    • sDate - Date value in string format

      Date values can be passed in different ways as string value:

      Standard: yyyy-mm-dd or yyyymmdd

      English: mm/dd/yyyy

      German: dd.mm.yyyy

      The type of date is determined from the separator used.

  12. to list
  13. Set ODABA date value from unix timestamp
    odaba::Date & Date  :: assign ( int64 iUnixTime )

    The Unix timestamp, which is passed in iUnixTime , contains the number of seconds since 1.1.1970 0:00:00.

    The Unix time stamp is converted into an ODABA date value ignoring the day time stored in the timestamp. It is up to the application interpreting the value as local or standard time.

    • iUnixTime - Unix time stamp

      The unix timestamp contains the number of seconds since 1.1.1970 0:00:00 (UTC), which is an absolute timestamp that might be converted into local time.

  14. to list