Tzmove: Stsadm operation (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2007-12-04

Operation name: Tzmove

Description

Enables an administrator to update data that is affected by a change in the start and/or end of daylight saving time (DST).

Note

The Tzmove operation was first introduced in Windows SharePoint Services 3.0 Service Pack 1.

Syntax

stsadm -o tzmove

**   -name <name of the history tag>**

**   -update {all | before}**

**    [-date] <YYYYMMDD>**

**   -clear**

Parameters

Parameter name

Value

Required?

Description

name

A valid name, such as "dst2007"

Yes

The name of the history tag that identifies the change in daylight saving time in the Timezone.xml file.

update

Either one of the following values:

  • All

  • Before

Yes

Note

Either the update parameter or the clear parameter must be specified, but not both.

All: Updates all date values that occur in the future and that are affected by the change in daylight saving time.

Before: Updates date values that occur in the future and that are affected by the change in daylight saving time that were changed before the date specified using the date parameter. This is useful when there is an update to the Timezone.xml file, but the tzmove operation is not immediately run.

date

A valid date in the form "YYYYMMDD"

No

When the update parameter has the value Before, the date parameter is required. When the update parameter is not specified or has the value All, this parameter should not be included.

clear

<none>

Yes

Note

Either the update parameter or the clear parameter must be specified, but not both.

By default, the tzmove operation will not update data more than once. The clear parameter allows the tzmove operation to be run again safely if a previous invocation of the operation was interrupted. However, if it is necessary to update data more than once (for example, when a time zone definition changes every year), the clear parameter prepares the data to updated again.

Remarks

As an example, say that November 3, 2007, was defined as standard time in the Timezone.xml file. However, it has been decided that standard time will occur one week early in your country, which changes the date of standard time to October 27, 2007. After updating Timezone.xml to reflect this change, date values that occur in this time period (in this example, between the last Sunday of October and the first Sunday in November) will be incorrect by one hour. The Tzmove operation would update this data so that it is correct.

The Timezone.xml file is located in the following location, "%COMMONPROGRAMFILES%\microsoft shared\web server extensions\12\config" folder.

For more information about Tzmove, see Microsoft Knowledge Base article 939809 (https://go.microsoft.com/fwlink/?LinkId=105804&clcid=0x409).

Examples

For the following examples, the following definitions apply:

  • Future data: This data consists of items that contain date values and time values that occur in the new DST period in the year that the DST period first comes into effect and beyond.

  • Past data: This data consists of items that contain date values and time values that occur in the new DST period in the years before the DST period first comes into effect.

  1. If you previously installed an update that modified the DST period of a time zone definition, you must run the following command to update the future data items:

    stsadm –o tzmove –name <name> –update before –date YYYYMMDD

    Note

    In this command, YYYYMMDD is the date on which you installed the update that modified the time zone definition.

  2. If you did not install an update, and if you modified the Timezone.xml file, you must run the following command to update the future data items:

    stsadm –o tzmove –name <name> –update before -date YYYYMMDD

    Note

    In this command, YYYYMMDD is the date on which the Timezone.xml file was modified.

  3. If you did not install an update that modified the DST period of a time zone definition, you must run the following command to update the future data items:

    stsadm -o tzmove -name <name> -update all

    Note

    In this command, all future data is updated.

  4. If the DST period for a time zone definition is modified again after you run the command, the previous data is not restored when you rerun the command. In this case, you must run the following command before you rerun the command:

    stsadm –o tzmove –name <name> -clear

    Note

    This procedure clears the internal flags that are set by the command, and it enables data to be modified again.