User Tools

Site Tools


en-us_commands:reference:irtcread

This is an old revision of the document!


IrtcRead()

IrtcRead() reads the RTC date and time.

IrtcRead command operation flow

bool IrtcRead(IrtcDateTime& dateTime)

Commands

Command Arguments Return Value Operation
IrtcRead(dateTime) IrtcDateTime& dateTime bool Reads the RTC date and time.

Example

void setup() {
  Serial.begin(115200);
 
  if (!IrtcBegin()) {  // Check the DS3231 RTC connection and begin operation.
    Serial.println(F("DS3231 connection failed"));
    return;
  }
 
  // Run once initially, then comment out.
  // IrtcSet(2026, 8, 10, 14, 30, 0);
}
 
void loop() {
  IrtcDateTime now;
  if (IrtcRead(now)) {  // Read the RTC date and time.
    Serial.print(now.year);
    Serial.print('/');
    Serial.print(now.month);
    Serial.print('/');
    Serial.print(now.day);
    Serial.print(' ');
    Serial.print(now.hour);
    Serial.print(':');
    Serial.print(now.minute);
    Serial.print(':');
    Serial.println(now.second);
  }
  delay(1000);
}

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 Command List

en-us_commands/reference/irtcread.1788791735.txt.gz · Last modified: by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki