{"record":{"id":"2ca7a0151ca1757d","repo":"hibernate/hibernate-orm","slug":"unsupported-datetime-field-ctx-gettext","errorCode":null,"errorMessage":"Unsupported datetime field [{ctx.getText()}]","messagePattern":"Unsupported datetime field \\[(.+?)\\]","errorType":"exception","errorClass":"ParsingException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java","lineNumber":4984,"sourceCode":"\t\t\t\t\tnodeBuilder().getLongType(),\n\t\t\t\t\tnodeBuilder\n\t\t\t);\n\t\t\tcase HqlParser.WEEK -> new SqmExtractUnit<>(\n\t\t\t\t\tTemporalUnit.WEEK,\n\t\t\t\t\tnodeBuilder().getIntegerType(),\n\t\t\t\t\tnodeBuilder\n\t\t\t);\n\t\t\tcase HqlParser.QUARTER -> new SqmExtractUnit<>(\n\t\t\t\t\tTemporalUnit.QUARTER,\n\t\t\t\t\tnodeBuilder().getIntegerType(),\n\t\t\t\t\tnodeBuilder\n\t\t\t);\n\t\t\tcase HqlParser.EPOCH -> new SqmExtractUnit<>(\n\t\t\t\t\tTemporalUnit.EPOCH,\n\t\t\t\t\tnodeBuilder().getLongType(),\n\t\t\t\t\tnodeBuilder\n\t\t\t);\n\t\t\tdefault -> throw new ParsingException( \"Unsupported datetime field [\" + ctx.getText() + \"]\" );\n\t\t};\n\t}\n\n\t@Override\n\tpublic Object visitDayField(HqlParser.DayFieldContext ctx) {\n\t\tfinal var nodeBuilder = nodeBuilder();\n\t\tfinal var symbol = ((TerminalNode) ctx.getChild( 2 )).getSymbol();\n\t\treturn switch ( symbol.getType() ) {\n\t\t\tcase HqlParser.MONTH ->\n\t\t\t\t\tnew SqmExtractUnit<>( DAY_OF_MONTH, nodeBuilder().getIntegerType(), nodeBuilder );\n\t\t\tcase HqlParser.WEEK ->\n\t\t\t\t\tnew SqmExtractUnit<>( DAY_OF_WEEK, nodeBuilder().getIntegerType(), nodeBuilder );\n\t\t\tcase HqlParser.YEAR ->\n\t\t\t\t\tnew SqmExtractUnit<>( DAY_OF_YEAR, nodeBuilder().getIntegerType(), nodeBuilder );\n\t\t\tdefault -> throw new ParsingException( \"Unsupported day field [\" + ctx.getText() + \"]\" );\n\t\t};\n\t}\n","sourceCodeStart":4966,"sourceCodeEnd":5002,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java#L4966-L5002","documentation":"Error \"Unsupported datetime field [{ctx.getText()}]\" thrown in hibernate/hibernate-orm.","triggerScenarios":"An invalid keyword/field is used in a datetime, pad, or trim expression: Unsupported datetime field [<value>]","commonSituations":"HQL queries using extract(), pad(), or trim() with a field/specification keyword that is not one of the documented values.","solutions":["The datetime field used in the extraction is not supported. Use a supported field (year, month, day, hour, minute, second, epoch, ...) for the extract()/datetime field expression."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}