. DirectXtras Home

DirectCommunication Xtra
DirectConnection Xtra
DirectControl Xtra
DirectEmail Xtra
DirectFTP Xtra
DirectImage Xtra
DirectInteraction Xtra
DirectOS Xtra
License Agreement
Licensing Fees
Order Form
DirectSMS Xtra
DirectSound Xtra
DirectTransition Xtra
DirectTransition3D Xtra Set I
DirectTransition3D Xtra Set II
DirectTransition3D Xtra Set III
DirectTTS Xtra
DirectXport Xtra


Special Discounted Bundles

The Gallery
How To Order
Order Form
Check for Upgrades

Sign in
Change Your Profile

Contact Us

Xtra Power for Director & Authorware

DirectOS Xtra
 Directing Windows and MacOS. The OS at your fingertips!

Authorware 4.x Compatible Authorware 5.x CompatibleAuthorware 6.x CompatibleAuthorware 7.x CompatibleDirector 5.x Compatible Director 6.x CompatibleDirector 7.x Compatible Director 8.x CompatibleDirector MX Compatible     MacOS 8.x and 9.x CompatibleWindows Compatible   

dosSetSystemDate(string NewDate)

Sets the system clock to the date specified by NewDate

The day of the week will automatically be set to the appropriate day. Note that changing the date may adjust the current hour of the system clock in response to daylight savings time on Windows NT, Windows 2000, Windows XP and later. If you wish to set both the time and date, make sure to call dosSetSystemDate() before dosSetSystemTime().

Parameter :

NewDate : A string specifying the new date to set the system clock to. The format is "month/day/year". For example, October 24th, 1979 would correspond to "10/24/1979". Do not insert any spaces or other unneeded characters into this string. 

Return Value : An integer indicating whether the method succeeded or failed. A value of 1 indicates that the method succeeded. A value of 0 indicates the method failed, in which case dosGetLastError() should be called to determine the cause of the error.

If you’re using the trial version of the Xtra please refrain from using this function as the trial version may expire as a result the date change.

Possible Returned Error Codes via dosGetLastError() :
10001 : Invalid format for parameter 1. 
10007 : Invalid value for month. 
10008 : Invalid value for day. 
10009 : Invalid date value. The date is beyond the system's capacity or the value for day is too high for the month specified. 

Remarks :

On MacOS classic, an error may or may not be returned if an improper date is given. It is the lingo programmer's responsibility to make sure the date given is a proper date. The method might still return a value of 1 indicating a success even if an invalid date is given in which case the date will be set to an incorrect date. Do not depend on the return value and the return value of dosGetLastError() to check for valid dates. 

This function is not supported on MacOS X.

DirectXtras Inc.
P.O Box 2645, Menlo Park, CA, 94026, U.S.A
Voice: +1-415-5058249, Fax: +1-801-8585841
Toll Free: 1-800-4453093
E-mail General Information: info@directxtras.com
E-mail Technical Support: support@directxtras.com

Copyright © 1996-2004 DirectXtras Inc. All Rights Reserved.
WebMaster: tamar@directxtras.com
Last Updated: 12/20/2002 5:18:44 AM.