Add new checkpoint parameter for date assert (sonic-net#21610)

What is the motivation for this PR?
Enhance the usability of the tool by adding verification for the new -t parameter. This parameter enables displaying the checkpoint datetime, which improves transparency and debugging capabilities for users.

Tools PR: sonic-net/sonic-utilities#3746

How did you do it?
Implemented logic to parse and validate the -t parameter in the command-line interface.
Updated the relevant code paths to ensure the checkpoint datetime is correctly retrieved and displayed.
Added error handling for invalid or missing -t values to maintain robustness.

How did you verify/test it?
Ran integration tests to confirm that the checkpoint datetime is displayed accurately when the parameter is used.

Signed-off-by: xincunli-sonic <xincun.li@microsoft.com>

Author: xincunli-sonic

tests/common/checkpoint.py

@@ -1,19 +1,29 @@
+import json
+import re
 import logging
 from tests.common.helpers.assertions import pytest_assert
+from sonic_py_common import device_info
 
 logger = logging.getLogger(__name__)
 
 DEFAULT_CHECKPOINT_NAME = "backup"
 
 
-def list_checkpoints(duthost):
-    """List checkpoint on target duthost
+def list_checkpoints(duthost, with_date=False):
+    """
+    List checkpoints on target duthost.
 
     Args:
         duthost: Device Under Test (DUT)
-        cp: checkpoint filename
+        with_date (bool): If True, include checkpoint creation date/time in the output
+        (requires SONiC version >= 202505 or master).
+
+    Returns:
+        dict: Output from duthost.shell command.
     """
     cmds = 'config list-checkpoints'
+    if with_date:
+        cmds += " -t"
 
     logger.info("Commands: {}".format(cmds))
     output = duthost.shell(cmds, module_ignore_errors=True)
@@ -29,8 +39,35 @@ def list_checkpoints(duthost):
 def verify_checkpoints_exist(duthost, cp):
     """Check if checkpoint file exist in duthost
     """
-    output = list_checkpoints(duthost)
-    return '"{}"'.format(cp) in output['stdout']
+    checkpoints_output = list_checkpoints(duthost)
+    checkpoint_exists = f'"{cp}"' in checkpoints_output['stdout']
+
+    output_version = device_info.get_sonic_version_info()
+    build_version = output_version['build_version']
+
+    # Detect version_number or bail out early
+    if not (re.match(r'^(\d{6})', build_version) or "master" in build_version):
+        return checkpoint_exists
+
+    # Resolve version_number
+    if "master" in build_version:
+        version_number = 999999
+    else:
+        version_number = int(re.findall(r'\d{6}', build_version)[0])
+
+    # Old versions: simple check
+    if version_number < 202505:
+        return checkpoint_exists
+
+    # Newer versions: need date-aware check
+    checkpoints_output = list_checkpoints(duthost, with_date=True)
+    try:
+        checkpoints = json.loads(checkpoints_output['stdout'])
+    except Exception:
+        checkpoints = []
+
+    checkpoint_exists_with_date = any(item.get("name") == cp for item in checkpoints)
+    return checkpoint_exists and checkpoint_exists_with_date
 
 
 def create_checkpoint(duthost, cp=DEFAULT_CHECKPOINT_NAME):