DateTime :: setDate - Set date for timestamp value

Setting the date value will not affect the time value in the timestamp.

Return value: Time stamp ( odaba::DateTime & )

A time stamp combines date and time

Implementation overview

Set current date value
DateTime :: setDate ( )
Set date by date value
DateTime :: setDate ( cDate )
Set date value by day, month and year
DateTime :: setDate ( iDay, iMonth, iYear )
Set date value from string
DateTime :: setDate ( sDate )

Implementation details

Set current date value
odaba::DateTime & DateTime :: setDate ( )

The function initializes date to the current date.

Set date by date value
odaba::DateTime & DateTime :: setDate ( odaba::Date &cDate )

The date is set to the date value passed in cDate.
- cDate - Date
  The date contains day, month and year, but not the time.

Set date value by day, month and year
odaba::DateTime & DateTime :: setDate ( int32 iDay, int32 iMonth, int32 iYear )

The function changes the date value to day, month and year passed in iDay, iMonth and iYear. When the day or month value exceeds the number of days in the defined month or 12, the month and year value will increase automatically.

When iDay, iMonth are less than 1 or iYear is less than 1870, the function throws an exception.
- iDay - Day
  Day of the month. The value should range between 1 and 31.
- iMonth - Month
  Month of the year. The value should range between 1 and 12.
- iYear - Year
  Number of the year. The value should no be negative.

Set date value from string
odaba::DateTime & DateTime :: setDate ( 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.