Timezone Conversion

API

Settings

• TimeConversion - Server timestamps are converted into the given timezone. You need to set the other properties for this to work. Default: FtpDate.ServerTime.

  • FtpDate.ServerTime will return the original timestamp.
  • FtpDate.LocalTime will convert the timestamp into your local machine's timezone.
  • FtpDate.UTC will convert the timestamp into UTC format (GMT+0).

• TimeZone - The timezone of the FTP server. If the server is in Tokyo with UTC+9 then set this to 9. If the server returns timestamps in UTC then keep this 0. Default: 0. Range: -14 to 14.

• LocalTimeZone (.NET core only) - The timezone of your machine. If your machine is in Tokyo with UTC+9 then set this to 9. If your machine is synchronized with UTC then keep this 0. Default: 0. Range: -14 to 14.

Utilities

• ConvertDate - Main method used to translate local dates to server dates. Typically converts the date provided by the FTP server into the timezone required locally. If reverse is true, converts the local timezone date into the date required by the FTP server. In most cases you will never need to use this directly.

FAQs

How do I set the TimeZone and LocalTimeZone properties?

You need to set it based on your timezone's offset from UTC/GMT. So if you want to use the Tokyo UTC+9 then set this to 9.

See the image below for the values you need to set it to: (it will accept any value in the range of -14 to 14)

How do I retrieve date/time values in UTC?

Set the server's timezone into TimeZone and then set TimeConversion = FtpDate.UTC

How do I retrieve date/time values in my local timezone?

Set the server's timezone into TimeZone and then set TimeConversion = FtpDate.LocalTime

For .NET Core/.NET Standard users: You need to set LocalTimeZone with the timezone of your machine.