Script API: add DateTime.Milliseconds, meaning ms in second (0-999)

Author: ivan-mogilko

Editor/AGS.Editor/Resources/agsdefns.sh

@@ -2420,7 +2420,9 @@ builtin managed struct DateTime {
   readonly import attribute int Minute;
   /// Gets the Second (0-59) component of the time.
   readonly import attribute int Second;
-  /// Gets the raw time value, useful for calculating elapsed time periods.
+  /// Gets the Milliseconds (0-999) component of the time.
+  readonly import attribute int Milliseconds;
+  /// Gets the raw time value (in seconds), useful for calculating elapsed time periods.
   readonly import attribute int RawTime;
 };
 

Engine/ac/datetime.cpp

@@ -80,6 +80,10 @@ int DateTime_GetSecond(ScriptDateTime *sdt) {
     return sdt->Second();
 }
 
+int DateTime_GetMilliseconds(ScriptDateTime *sdt) {
+    return sdt->Milliseconds();
+}
+
 int DateTime_GetRawTime(ScriptDateTime *sdt) {
     return sdt->RawTime();
 }
@@ -146,6 +150,12 @@ RuntimeScriptValue Sc_DateTime_GetSecond(void *self, const RuntimeScriptValue *p
     API_OBJCALL_INT(ScriptDateTime, DateTime_GetSecond);
 }
 
+RuntimeScriptValue Sc_DateTime_GetMilliseconds(void *self, const RuntimeScriptValue *params, int32_t param_count)
+{
+    API_OBJCALL_INT(ScriptDateTime, DateTime_GetMilliseconds);
+}
+
+
 // int (ScriptDateTime *sdt)
 RuntimeScriptValue Sc_DateTime_GetRawTime(void *self, const RuntimeScriptValue *params, int32_t param_count)
 {
@@ -161,6 +171,7 @@ void RegisterDateTimeAPI()
 
         { "DateTime::get_DayOfMonth", API_FN_PAIR(DateTime_GetDayOfMonth) },
         { "DateTime::get_Hour",       API_FN_PAIR(DateTime_GetHour) },
+        { "DateTime::get_Milliseconds", API_FN_PAIR(DateTime_GetMilliseconds) },
         { "DateTime::get_Minute",     API_FN_PAIR(DateTime_GetMinute) },
         { "DateTime::get_Month",      API_FN_PAIR(DateTime_GetMonth) },
         { "DateTime::get_RawTime",    API_FN_PAIR(DateTime_GetRawTime) },

Engine/ac/dynobj/scriptdatetime.cpp

@@ -82,6 +82,7 @@ void ScriptDateTime::SetTime(const ClockTimePoint &time)
     }
 
     _rawtime = static_cast<int32_t>(rawtime);
+    _msSinceSecond = std::chrono::duration_cast<std::chrono::milliseconds>(time.time_since_epoch()).count() % 1000;
     _hour = newtime->tm_hour;
     _minute = newtime->tm_min;
     _second = newtime->tm_sec;
@@ -104,6 +105,8 @@ void ScriptDateTime::Serialize(const void* /*address*/, Stream *out)
     out->WriteInt32(_minute);
     out->WriteInt32(_second);
     out->WriteInt32(_rawtime);
+    // v3.6.3.3
+    out->WriteInt32(_msSinceSecond);
 }
 
 void ScriptDateTime::Unserialize(int index, Stream *in, size_t /*data_sz*/)
@@ -115,5 +118,7 @@ void ScriptDateTime::Unserialize(int index, Stream *in, size_t /*data_sz*/)
     _minute = in->ReadInt32();
     _second = in->ReadInt32();
     _rawtime = in->ReadInt32();
+    // v3.6.3.3
+    _msSinceSecond = in->ReadInt32();
     ccRegisterUnserializedObject(index, this, this);
 }

Engine/ac/dynobj/scriptdatetime.h

@@ -50,10 +50,12 @@ struct ScriptDateTime final : AGSCCDynamicObject
     inline int Hour() const { return _hour; }
     inline int Minute() const { return _minute; }
     inline int Second() const { return _second; }
+    inline int Milliseconds() const { return _msSinceSecond; }
 
 private:
     int _year = 0, _month = 0, _day = 0;
     int _hour = 0, _minute = 0, _second = 0;
+    int _msSinceSecond = 0;
     int _rawtime = -1;
 
     void SetTime(const ClockTimePoint &time);