protected String path;

    /** The timestamp when this dictionary file was created or last modified. */
    protected Date timestamp;

    /**
     * Creates a new DictionaryFile with the specified parameters.
     *
     * @param id the unique identifier for this dictionary file
     * @param path the file path of this dictionary
     * @param timestamp the timestamp of the dictionary file
     */

        monitorTarget.appendTimestamp(buf);
        String result = buf.toString();
        assertTrue(result.startsWith("\"timestamp\":\""));
        assertTrue(result.endsWith("\""));
        // Verify a timestamp was properly formatted
        assertNotNull(result);
        assertTrue(result.length() > "\"timestamp\":\"\"".length());
    }

    // Test appendException method with simple exception

            }
            return null;
        }).orElse(value);
    }

    /**
     * Converts a Long timestamp to a Date object.
     *
     * @param value the timestamp in milliseconds
     * @return Date object representing the timestamp, or null if value is null
     */
    public static Date date(final Long value) {
        if (value == null) {
            return null;
        }

        // Default constructor
    }

    /** Logger instance for this class. */
    private static final Logger logger = LogManager.getLogger(CrawlerStatsHelper.class);

    /** Key used to store the begin timestamp in statistics objects. */
    private static final String BEGIN_KEY = "begin";

    /** Logger instance specifically for outputting crawler statistics. */
    protected Logger statsLogger = null;

    /**
     * Purges old suggest data from documents.
     *
     * @param time The timestamp to purge data before.
     */
    public void purgeDocumentSuggest(final LocalDateTime time) {
        final BoolQueryBuilder boolQueryBuilder = QueryBuilders.boolQuery();
        boolQueryBuilder
                .must(QueryBuilders.rangeQuery(FieldNames.TIMESTAMP).lt(time.atZone(ZoneId.systemDefault()).toInstant().toEpochMilli()));

                Set.of(), //
                buildQuery("timestamp:[* TO 100]"));
        assertQueryContext(

     * @return the actual version string with timestamp and build number, or null if not found
     * @throws SAXException if XML parsing fails
     * @throws IOException if I/O error occurs
     */
    protected String getSnapshotActualVersion(final DocumentBuilder builder, final String pluginUrl, final String version)
            throws SAXException, IOException {
        String timestamp = null;
        String buildNumber = null;

        assertEquals(currentTime, searchRenderData.getRequestedTime());

        // Test with specific timestamp
        long timestamp = 1609459200000L; // 2021-01-01 00:00:00 UTC
        searchRenderData.setRequestedTime(timestamp);
        assertEquals(timestamp, searchRenderData.getRequestedTime());

        // Test with negative value
        searchRenderData.setRequestedTime(-1000L);

                    final Date timestamp =
                            new SimpleDateFormat(Constants.DATE_FORMAT_ISO_8601_EXTEND_UTC).parse(fileMap.get("@timestamp").toString());
                    for (final DictionaryCreator creator : creatorList) {
                        final DictionaryFile<? extends DictionaryItem> file = creator.create(path, timestamp);
                        if (file != null) {

                "site:aaa");

        assertQueryBuilder("{\"timestamp\":{\"order\":\"asc\"}}", "sort:timestamp");
        assertQueryBuilder("{\"timestamp\":{\"order\":\"asc\"}}", "sort:timestamp.asc");
        assertQueryBuilder("{\"timestamp\":{\"order\":\"desc\"}}", "sort:timestamp.desc");

        try {
            assertQueryBuilder("", "sort:xxx");
            fail();