UpdateCalendarEventDTO
extends AbstractBaseDto
in package
UpdateCalendarEventDTO
Data Transfer Object for updating calendar events in Canvas LMS. Handles the transformation of calendar event update data into the multipart format expected by the Canvas API.
Table of Contents
Properties
- $allDay : bool|null
- When true, event is considered to span the whole day and times are ignored
- $blackoutDate : bool|null
- If true, this event represents a holiday or special day that does not count in course pacing
- $childEventData : array<string, DateTime, context_code?: string}>|null
- Section-level child event data for course events Format: ['X' => ['start_at' => DateTime, 'end_at' => DateTime, 'context_code' => string]]
- $contextCode : string|null
- Context code of the course, group, user, or account to move this event to Scheduler appointments and events with section-specific times cannot be moved between calendars Format: {type}_{id} (e.g., 'course_123', 'user_456', 'group_789', 'account_1')
- $description : string|null
- Longer HTML description of the event
- $endAt : DateTime|null
- End date/time of the event
- $locationAddress : string|null
- Location address
- $locationName : string|null
- Location name of the event
- $rrule : string|null
- Valid if the event is part of a series Defines the shape of the recurring event series after it's updated iCalendar RRULE (unending series not supported)
- $startAt : DateTime|null
- Start date/time of the event
- $timeZoneEdited : string|null
- Time zone of the user editing the event Allowed time zones are IANA time zones or friendlier Ruby on Rails time zones
- $title : string|null
- Short title for the calendar event
- $apiPropertyName : string
- The name of the property in the API
Methods
- __construct() : mixed
- BaseDto constructor.
- toApiArray() : array<int, array{name: string, contents: string}>
- Convert DTO to API-compatible array format
- toArray() : array<string|int, mixed>
- Convert the DTO to an array
Properties
$allDay
When true, event is considered to span the whole day and times are ignored
public
bool|null
$allDay
= null
$blackoutDate
If true, this event represents a holiday or special day that does not count in course pacing
public
bool|null
$blackoutDate
= null
$childEventData
Section-level child event data for course events Format: ['X' => ['start_at' => DateTime, 'end_at' => DateTime, 'context_code' => string]]
public
array<string, DateTime, context_code?: string}>|null
$childEventData
= null
$contextCode
Context code of the course, group, user, or account to move this event to Scheduler appointments and events with section-specific times cannot be moved between calendars Format: {type}_{id} (e.g., 'course_123', 'user_456', 'group_789', 'account_1')
public
string|null
$contextCode
= null
$description
Longer HTML description of the event
public
string|null
$description
= null
$endAt
End date/time of the event
public
DateTime|null
$endAt
= null
$locationAddress
Location address
public
string|null
$locationAddress
= null
$locationName
Location name of the event
public
string|null
$locationName
= null
$rrule
Valid if the event is part of a series Defines the shape of the recurring event series after it's updated iCalendar RRULE (unending series not supported)
public
string|null
$rrule
= null
$startAt
Start date/time of the event
public
DateTime|null
$startAt
= null
$timeZoneEdited
Time zone of the user editing the event Allowed time zones are IANA time zones or friendlier Ruby on Rails time zones
public
string|null
$timeZoneEdited
= null
$title
Short title for the calendar event
public
string|null
$title
= null
$apiPropertyName
The name of the property in the API
protected
string
$apiPropertyName
= ''
Methods
__construct()
BaseDto constructor.
public
__construct(array<string|int, mixed> $data) : mixed
Parameters
- $data : array<string|int, mixed>
Tags
toApiArray()
Convert DTO to API-compatible array format
public
toApiArray() : array<int, array{name: string, contents: string}>
Return values
array<int, array{name: string, contents: string}>toArray()
Convert the DTO to an array
public
toArray() : array<string|int, mixed>