PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Properties specific to the description of gglEvent variables
  • Managing dates and time zones
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
The gglEvent type is used to describe and modify an event of a calendar. The calendar is described via the gglCalendar type. This calendar is used by the Google Calendar service.
Remark: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties.
Example
// Connect to Google
Cnt is gglConnection
Cnt.Email = "balthazar@gmail.com"
Cnt.Password = "qwerty"
Cnt.ApplicationName = "MyApp-01"
IF GglConnect(Cnt) = False THEN
Error(ErrorInfo())
END
...
// Retrieve the array of available calendars
arrCalendars is array of gglCalendar
arrCalendars = GglListCalendar(Cnt)
// Retrieve all the events of the first calendar
GglFillCalendar(Cnt, arrCalendars[1])
// Browse the events
Evt is gglEvent
FOR EACH Evt OF arrCalendars[1]
Trace(Evt.Title)
Trace(Evt.Color)
Trace(Evt.Notification.Default)
Trace(Evt.Notification.Override.Count)
Trace(Evt.Visibility)
Trace(Evt.Availability)
Trace(Evt.Attachment.Occurrence)
FOR EACH ANotif OF Evt.Notification.Override
Trace(ANotif.Method)
Trace(ANotif.NbMinute)
END
FOR EACH AFile OF Evt.Attachment
Trace(AFile.FileId)
Trace(AFile.Title)
Trace(AFile.FileURL)
Trace(AFile.IconURL)
Trace(AFile.MIMEType)
END
END
Remarks

Properties specific to the description of gglEvent variables

The following properties can be used to handle a calendar event via the gglEvent type:
NameType usedEffect
AuthorgglAuthorAuthor of the calendar. This property is accessible in read-only.
ContentUnicode stringDescription of the event.
Versions 26 and later
Color
New in version 26
Color
Color
Unicode stringEvent color identifier. The following colors are available:
StartDateDateTimeStart date of the event.
Remarks:
  • In the Google interface, if the event corresponds to a full day, the start date of the event is the one of the day at 0h00.
  • The date is expressed in the time zone of the local computer.
EndDateDateTimeEnd date of the event.
Remarks:
  • In the Google interface, if the event corresponds to a full day, the end date of the event is the one of the next day at 0h00.
  • The date is expressed in the time zone of the local computer.
UpdateDateDateTimeDate the event is updated. This property is accessible in read-only.
Remark: The date is expressed in the time zone of the local computer.
Versions 26 and later
Availability
New in version 26
Availability
Availability
String constantAvailability of the event. This property can correspond to the following constants:
  • gglOpaque: Busy.
  • gglTransparent: Available.
Versions 15 and later
Identifier
New in version 15
Identifier
Identifier
Unicode stringGoogle identifier of the event.
Versions 18 and later
WholeDay
New in version 18
WholeDay
WholeDay
  • True if the event corresponds to entire days,
  • False otherwise.
Guest[n]Array of gglPersonList of participants to the event.
Caution: When modifying an event, the participants are not automatically informed of the modifications performed. This feature must be programmed if necessary.
LocationList of locations associated with the event.
Versions 26 and later
Notification
New in version 26
Notification
Notification
gglNotification variableNotifications related to the event.
Versions 26 and later
Attachment
New in version 26
Attachment
Attachment
gglAttachment variableAttachments of the event.
TitleUnicode stringTitle of the event.
Versions 26 and later
Visibility
New in version 26
Visibility
Visibility
String constantVisibility of the event. This property can correspond to the following constants:
  • gglConfidential: The event is confidential.
  • gglDefault: Default visibility.
  • gglPublic: The event is visible to all users with access to the calendar.
  • gglPrivate: The event is private.
Versions 20 and later

Managing dates and time zones

Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone.
To convert them into a specific time zone, you can use DateTimeLocalToTimeZone or DateTimeLocalToUTC.
You can retrieve the time zone of the calendar accessed via the TimeZone property of gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone.
New in version 20

Managing dates and time zones

Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone.
To convert them into a specific time zone, you can use DateTimeLocalToTimeZone or DateTimeLocalToUTC.
You can retrieve the time zone of the calendar accessed via the TimeZone property of gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone.

Managing dates and time zones

Further to the use of the "OAuth 2.0" authentication, the management of dates was modified. All the dates returned by GglGetCalendar, GglListCalendar, ... in the gglEvent variables are using the time zone of the local computer. Therefore, they can be directly used in a Calendar control with the current time zone.
To convert them into a specific time zone, you can use DateTimeLocalToTimeZone or DateTimeLocalToUTC.
You can retrieve the time zone of the calendar accessed via the TimeZone property of gglCalendar variables. The returned value corresponds to the name of the time zone, issued from the "tz" database (or Olson database). This name can be directly used by DateTimeLocalToTimeZone.
Minimum version required
  • Version 14
This page is also available for…
Comments
Click [Add] to post a comment