ILOGICS Product Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== IrtcUnixTime() ======

''IrtcUnixTime()'' returns the current time as Unix time.

{{:en-us_commands:reference:irtcunixtime.svg?900|IrtcUnixTime command operation flow}}

''bool IrtcUnixTime(uint32_t& unixTime)''

===== Commands =====

^ Command ^ Arguments ^ Return Value ^ Operation ^
| ''IrtcUnixTime(unixTime)'' | ''uint32_t& unixTime'' | ''bool'' | Returns the current time as Unix time. |


===== Example =====

<code cpp>
void setup() {
  Serial.begin(115200);
  if (!IrtcBegin()) return;  // Check the DS3231 RTC connection and begin operation.

  bool valid = false;
  if (IrtcTimeValid(valid) && !valid) {  // Check whether the RTC time is reliable.
    IrtcSet(2026, 9, 7, 9, 0, 0);  // Set the RTC date and time.
    IrtcClearOscillatorStopFlag();  // Clear the oscillator-stop flag.
  }
}

void loop() {
  IrtcDateTime now;
  uint32_t unixTime = 0;
  float rtcTemperature = 0.0F;
  if (IrtcRead(now) && IrtcUnixTime(unixTime) && IrtcGetTemperature(rtcTemperature)) {  // Return the RTC's internal temperature. / Return the current time as Unix time. / Read the RTC date and time.
    Serial.print(unixTime); Serial.print(','); Serial.println(rtcTemperature, 2);
  }
  delay(1000);
}
</code>

===== Precautions =====

Run each device's corresponding ''Begin'' command first. Check I²C addresses and pin sharing; if the ''bool'' return value is ''false'', inspect wiring and power.

===== Built-in Commands in the Same Category =====

  * [[:en-us_commands:reference:irtcbegin|IrtcBegin() View detailed description]]
  * [[:en-us_commands:reference:irtcread|IrtcRead() View detailed description]]
  * [[:en-us_commands:reference:irtcset|IrtcSet() View detailed description]]
  * [[:en-us_commands:reference:irtcgettemperature|IrtcGetTemperature() View detailed description]]
  * [[:en-us_commands:reference:irtctimevalid|IrtcTimeValid() View detailed description]]
  * [[:en-us_commands:reference:irtcclearoscillatorstopflag|IrtcClearOscillatorStopFlag() View detailed description]]
  * [[:en-us_commands:reference:irtcsetalarm1|IrtcSetAlarm1() View detailed description]]
  * [[:en-us_commands:reference:irtcsetalarm2|IrtcSetAlarm2() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmenable|IrtcAlarmEnable() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmenabled|IrtcAlarmEnabled() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmtriggered|IrtcAlarmTriggered() View detailed description]]
  * [[:en-us_commands:reference:irtcsquarewave|IrtcSquareWave() View detailed description]]
  * [[:en-us_commands:reference:irtc32khz|Irtc32kHz() View detailed description]]

[[:en-us_commands:builtin|← Built-in Command List]]