Sun Java System Calendar Server 6 2005Q4 Developer's Guide

Command: gettime

Purpose

Gets the server time for the requested calendars.

Parameters

Table 7–21 gettime Parameters

Parameter  

Type  

Purpose  

Required  

Default  

calid

semicolon-separated list of strings 

A list of calendar identifiers. 

Current user’s calid 

fmt-out

string 

The format for the returned data. 

Two format types: 

text/calendar

text/xml

text/calendar

id

unique identifier string 

The session identifier. 

N/A 

tzidout

time zone ID string 

Time zone to report returned data in. 

Zulu time 

Description

Calendars must have given read permission to the user requesting the server time. Returns the server time of the server where the calendar is stored.

Error Codes

Example

Valid session with tzidout


http://calendarserver/gettime.wcap
               ?id=br6e8vx9ek02n2ow9
               &calid=jdoe
               &tzidout=America/Los_Angeles
BEGIN:VCALENDAR
PRODID:-//SunONE/Calendar Hosting Server//EN
VERSION:2.0
X-NSCP-WCAPTIME:20021021T082743
X-NSCP-WCAP-ERRNO:0
END:VCALENDAR