1

Time Zone and DST

Тема: Time Zone and DST

Hi Gt

Would you please let me know which commands responses are based on TZ and DST of user and which ones are based on GMT?
I want to know for which commands response we have to recalculate times based on user TZ and DST.

2

Time Zone and DST

Re: Time Zone and DST

Hi Hamed,

In all requests you need to specify GMT+0 time, by default the responses will be also with GMT+0
But after login you can execute request  render/set_locale to set user timezone for layers (messages) and reports.

Diana Cheley
Wialon Hosting Expert
Gurtam
3

Time Zone and DST

Re: Time Zone and DST

Hi Diana

May you tell me when exactly I should execute render/set_locale? After login and only one time or before/after each messages request/report execution?

4

Time Zone and DST

Re: Time Zone and DST

hhamedk пишет:

Hi Diana

May you tell me when exactly I should execute render/set_locale? After login and only one time or before/after each messages request/report execution?


Hi Hamed!

After login only, so you login, get session Id, execute request  render/set_locale once time for this session.
If new session is activated, you need to execute the request to render/set_locale on new session.

Diana Cheley
Wialon Hosting Expert
Gurtam
5

Time Zone and DST

(04/08/2021 11:11:53 отредактировано hhamedk)

Re: Time Zone and DST

Diana I have 2 other questions:

1. I see in documents that the flag can be 0,1 or 2 but the Wialon itself send flag 256. Please let me know what is that.

2. I call render/set_locale but when I put "formatDate":"%Y-%m-%E %H:%M:%S" and call it I receive error 4. Please let me know what I'm doing wrong.

http://hst-api.wialon.com/wialon/ajax.html?svc=render/set_locale&params={"tzOffset":134221328,"language":"fr","flags":256,"formatDate":"%Y-%m-%E %H:%M:%S"}&sid=SID

3. The case of time zone and daylight saving time confused me. As an example we have the Iran timezone and Iran daylight setting for a user:

A. We know that time zone is GMT+3:30 equal to +12600
B. We know that right know the daylight for Iran should be applied and the daylight offset is +1:00 which is equal to +3600
C. So now for this account we should have GMT+4:30 and in Wialon itself we see exactly same value in time current time section of bottom panel.

After we set mentioned time zone and daylight settings, we login with API as same user and we receive:

"prp": {
            "dst": "-1",
            "forceAddedDashboardTabOnce": "1",
            "fpnl": "monitoring",
            "geodata_source": "map_webgis",
            "hbacit": "{\"hb_mi_dashboard\":{},\"hb_mi_monitoring\":{\"l\":1},\"hb_mi_routes\":{\"l\":1},\"hb_mi_messages\":{\"l\":1},\"hb_mi_reports_ctl\":{\"l\":1},\"hb_mi_geozones\":{\"l\":1},\"hb_mi_drivers\":{\"l\":1},\"hb_mi_trailers\":{\"l\":1},\"hb_mi_tags\":{\"l\":1},\"hb_mi_jobs\":{},\"hb_mi_notifications\":{},\"hb_mi_users\":{},\"hb_mi_devices\":{},\"hb_mi_tools\":{},\"hb_mi_apps\":{}}",
            "hide_tl_promotion_tooltip": "1",
            "hpnl": "hb_mi_monitoring",
            "language": "en",
            "minimap_zoom_level": "15",
            "mont": "1",
            "monu": "[23582700,23662294,23745708,23753307,23881796,23886522]",
            "monuv": "[\"23662294\"]",
            "mtg": "1",
            "mu_fast_report_tmpl": "23978317_1",
            "mu_fast_track_ival": "0",
            "mu_tbl_cols_sizes": "ldt:256,0.22,0.26,0.26,0.26;ld:192,0.28,0.36,0.36;lt:192,0.28,0.36,0.36;dt:192,0.28,0.36,0.36;l:128,0.45,0.55;t:128,0.45,0.55;d:128,0.45,0.55;f:430,1",
            "notify_block_account": "0",
            "radd": "{\"w\":\"4\",\"c\":1,\"u\":23662294,\"a\":1,\"td\":1,\"s\":\"default\",\"f\":32}",
            "show_log": "0",
            "tz": "168571192",
            "umap": "g.vector@modern",
            "unit_extra_order": "1:connection,sensorValues,messageParams,customFields,profileFields,serviceIntervals,trailers,drivers",
            "us_addr_fmt": "1255211008_10_5",
            "us_addr_ordr": "1255211008"
        }

As you see the value for the parameters "dst" and "tz" are "-1" and "168571192" respectively.

first of all, I can't understand the value "-1" for "dst"

Then, if we do the calculation that is explained in http://sdk.wialon.com/wiki/en/sidebar/r … me/example as Reverse operation, we will reach to the value of +12600 (Equal to +3:30).
I expect +4:30, why +3:30? If it's correct then how we should find the daylight saving time? If the "dst" value was "+1" we could say sum these values and you will reach to +4:30, but now, I got confused.

6

Time Zone and DST

Re: Time Zone and DST

Hi Hamed,

1. flags value is 256 , just default value which uses when nothing should be changed.
You can use this flag like described in documentation,

2. For  "formatDate" you need to URL-encoded %  and : symbols, like %25 and %3A, space to %20
"%25E-%25m-%25Y%20%25H%3A%25M%3A%25S"

https://www.w3schools.com/tags/ref_urlencode.ASP

3. The value for Iran timezone GMT+3:30 is 12600
DST time is 0x0A0C0000 = 168558592 (dec) -     Iran: from March 22 to September 22 (from March 21 to September 21 in a leap year)

So you need set up both (sum of timezone + DST) for  "tzOffset":168571192 = 168558592 +12600
as your add DST value to tz , Wialon will be add 1 hour to GMT+3:30 , so it will +4.30 during DST period (from March 22 - Sep 22) , after Sep 22 the time will be automatically changed - minus 1 hour. So it doesn't need to edit timezone after 22 Sep

Diana Cheley
Wialon Hosting Expert
Gurtam
7

Time Zone and DST

Re: Time Zone and DST

Diana, thank you for your prompt response.

The response as you see says:

"tz": "168571192"

Please let me know how from 168571192 should we reach to  >>>  Iran timezone GMT+3:30 = 12600 and  DST time 0x0A0C0000 = 168558592 (dec)
Considering http://sdk.wialon.com/wiki/en/sidebar/r … me/example
Show me step-by-step calculation

8

Time Zone and DST

Re: Time Zone and DST

hhamedk пишет:

Diana, thank you for your prompt response.

The response as you see says:

"tz": "168571192"

Please let me know how from 168571192 should we reach to  >>>  Iran timezone GMT+3:30 = 12600 and  DST time 0x0A0C0000 = 168558592 (dec)
Considering http://sdk.wialon.com/wiki/en/sidebar/r … me/example
Show me step-by-step calculation

If the timezone value is positive, like GMT+3:30 you can just sum up 2 values : DST value (168558592) plus time 12600

or 168571192 - DST value (168558592)  = 12600

it's the same as using binary operation AND:

A0C3138 (tz=168571192) ∧ FFFF = 3138 HEX (or  12600 dec)


Or get DST

A0C3138∧0fff0000 (the mask for DST) = A0C0000 (or 168558592 in dec)

Diana Cheley
Wialon Hosting Expert
Gurtam
9

Time Zone and DST

(04/08/2021 18:56:44 отредактировано hhamedk)

Re: Time Zone and DST

Diana, let me ask my question another way. Simply, we receive "tz": "168571192" from an account. How to understand what is the Time Zone and DST from 168571192. How to calculate Time Zone and DST from 168571192. Is it clear?

Other questions are: what is what is the meaning of "dst": "-1" in login response? Which other values can have the "dst" parameter and what's the meaning of other values?

10

Time Zone and DST

Re: Time Zone and DST

hhamedk пишет:

Diana, let me ask my question another way. Simply, we receive "tz": "168571192" from an account. How to understand what is the Time Zone and DST from 168571192. How to calculate Time Zone and DST from 168571192. Is it clear?

Other questions are: what is what is the meaning of "dst": "-1" in login response? Which other values can have the "dst" parameter and what's the meaning of other values?

Hi Hamed,

the parameter 'dst' is not used, only used parameter 'tz' which value includes both timezone and DST

Diana Cheley
Wialon Hosting Expert
Gurtam