DATEVALUE function
PRO
BASIC
The DATEVALUE
function in Jspreadsheet Formulas Pro is a tool that changes a text string representing a date into a serial number, wwhich Jspreadsheet recognizes as a valid date value. This is useful when working with dates stored as text that need to be converted for use in date calculations or formatting. For example, the text '1-Jan-2020' can be converted into the serial number 43831, which Jspreadsheet identifies as a date. This function is a helpful way to manage and manipulate date data within your spreadsheet.
Documentation
Converts a text string that represents a date to a serial number that Excel recognizes as a date.
Category
Date and time
Syntax
DATEVALUE(date_text)
Parameter | Description |
---|---|
date_text |
A text string that represents a date in a recognizable format. For example, "2022-01-01" or "January 1, 2022". |
Behavior
The DATEVALUE
function converts a date that is stored as text into a serial number recognized as a date. For example, "1/1/2021" as text can be converted to the date serial number 44197. The serial number represents the number of days passed since January 1, 1900, which is the system used to calculate dates.
- When an empty cell is referenced, the
DATEVALUE
function will return a#VALUE!
error. - For text, if it represents a valid date,
DATEVALUE
will convert it into the corresponding serial number. If the text does not represent a valid date, a#VALUE!
error is returned. - Booleans are not valid arguments for the
DATEVALUE
function and will return a#VALUE!
error. - If the function encounters an error value in its input, it will propagate that error to its output.
Common Errors
Error | Description |
---|---|
#VALUE! | The input is not a valid date, is non-numeric, or the function encounters an empty cell. |
#REF! | The cell reference is not valid. This could be due to deleting a row, column, or cell that the function is referencing. |
Best practices
- Always ensure that the date text you are trying to convert is in a recognized date format. If the date text is not in a correct format, the
DATEVALUE
function will return a#VALUE!
error.- Use error handling functions like 'IFERROR' or 'ISERROR' along with
DATEVALUE
to handle any possible errors and maintain the cleanliness of your data.- Avoid referencing empty cells within your
DATEVALUE
function to prevent unwanted#VALUE!
errors.- Use
DATEVALUE
in conjunction with other date functions for more complex date manipulations and calculations.
Usage
A few examples using the DATEVALUE function.
DATEVALUE("2022-03-15") // Returns: 44635
DATEVALUE("2025-12-31") // Returns: 46022
DATEVALUE("2024-02-22") // Returns: 45344
DATEVALUE("January 1, 2020") // Returns: 43831
DATEVALUE("1/1/2021") // Returns: 44197
Interactive Spreadsheet Demo
<html>
<script src="https://jspreadsheet.com/v11/jspreadsheet.js"></script>
<script src="https://jsuites.net/v5/jsuites.js"></script>
<link rel="stylesheet" href="https://jsuites.net/v5/jsuites.css" type="text/css" />
<link rel="stylesheet" href="https://jspreadsheet.com/v11/jspreadsheet.css" type="text/css" />
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Material+Icons" />
<script src="https://cdn.jsdelivr.net/npm/@jspreadsheet/formula-pro/dist/index.min.js"></script>
<div id="spreadsheet"></div>
<script>
// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('MmZhNjRmZDczYzI3NmRjMzJhYTBhMGRkNmYwMGU5YzczNjI2MDZlMDRiNWIzMWM0YWM1NTdkNGJiZTQwMTYzYzQ0NmVmOWYyYmZmZmYwMjM5OTU1NTFiNTliNjUyYzgxNTk4ODkzMGY3NTY1NzNiNmIwMWQxNGE3MWE3MWU3MmMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVMk56a3lPVEExTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');
// Set the extensions
jspreadsheet.setExtensions({ formula });
// Create a new spreadsheet
jspreadsheet(document.getElementById('spreadsheet'), {
worksheets: [{
data: [
[
"Date Text",
"Serial Number",
"Formatted Date"
],
[
"2024-01-15",
"=DATEVALUE(A2)",
"=TEXT(B2,\"mm/dd/yyyy\")"
],
[
"2024-06-30",
"=DATEVALUE(A3)",
"=TEXT(B3,\"mm/dd/yyyy\")"
],
[
"2024-12-25",
"=DATEVALUE(A4)",
"=TEXT(B4,\"mm/dd/yyyy\")"
]
]
}]
});
</script>
</html>
import React, { useRef } from "react";
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/react";
import formula from "@jspreadsheet/formula-pro";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";
// Set license
jspreadsheet.setLicense('MmZhNjRmZDczYzI3NmRjMzJhYTBhMGRkNmYwMGU5YzczNjI2MDZlMDRiNWIzMWM0YWM1NTdkNGJiZTQwMTYzYzQ0NmVmOWYyYmZmZmYwMjM5OTU1NTFiNTliNjUyYzgxNTk4ODkzMGY3NTY1NzNiNmIwMWQxNGE3MWE3MWU3MmMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVMk56a3lPVEExTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');
// Set the extensions
jspreadsheet.setExtensions({ formula });
export default function App() {
// Spreadsheet array of worksheets
const spreadsheet = useRef();
// Worksheet data
const data = [
[
"Date Text",
"Serial Number",
"Formatted Date"
],
[
"2024-01-15",
"=DATEVALUE(A2)",
"=TEXT(B2,\"mm/dd/yyyy\")"
],
[
"2024-06-30",
"=DATEVALUE(A3)",
"=TEXT(B3,\"mm/dd/yyyy\")"
],
[
"2024-12-25",
"=DATEVALUE(A4)",
"=TEXT(B4,\"mm/dd/yyyy\")"
]
];
// Render component
return (
<Spreadsheet ref={spreadsheet}>
<Worksheet data={data} />
</Spreadsheet>
);
}
<template>
<Spreadsheet ref="spreadsheet">
<Worksheet :data="data" />
</Spreadsheet>
</template>
<script>
import { Spreadsheet, Worksheet, jspreadsheet } from "@jspreadsheet/vue";
import "jsuites/dist/jsuites.css";
import "jspreadsheet/dist/jspreadsheet.css";
import formula from "@jspreadsheet/formula-pro";
// Set license
jspreadsheet.setLicense('MmZhNjRmZDczYzI3NmRjMzJhYTBhMGRkNmYwMGU5YzczNjI2MDZlMDRiNWIzMWM0YWM1NTdkNGJiZTQwMTYzYzQ0NmVmOWYyYmZmZmYwMjM5OTU1NTFiNTliNjUyYzgxNTk4ODkzMGY3NTY1NzNiNmIwMWQxNGE3MWE3MWU3MmMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVMk56a3lPVEExTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');
// Set the extensions
jspreadsheet.setExtensions({ formula });
export default {
components: {
Spreadsheet,
Worksheet,
},
data() {
// Worksheet data
const data = [
[
"Date Text",
"Serial Number",
"Formatted Date"
],
[
"2024-01-15",
"=DATEVALUE(A2)",
"=TEXT(B2,\"mm/dd/yyyy\")"
],
[
"2024-06-30",
"=DATEVALUE(A3)",
"=TEXT(B3,\"mm/dd/yyyy\")"
],
[
"2024-12-25",
"=DATEVALUE(A4)",
"=TEXT(B4,\"mm/dd/yyyy\")"
]
]
return {
data
};
}
}
</script>
import { Component, ViewChild, ElementRef } from "@angular/core";
import jspreadsheet from "jspreadsheet";
import * as formula from "@jspreadsheet/formula-pro";
// Set your JSS license key (The following key only works for one day)
jspreadsheet.setLicense('MmZhNjRmZDczYzI3NmRjMzJhYTBhMGRkNmYwMGU5YzczNjI2MDZlMDRiNWIzMWM0YWM1NTdkNGJiZTQwMTYzYzQ0NmVmOWYyYmZmZmYwMjM5OTU1NTFiNTliNjUyYzgxNTk4ODkzMGY3NTY1NzNiNmIwMWQxNGE3MWE3MWU3MmMsZXlKamJHbGxiblJKWkNJNklpSXNJbTVoYldVaU9pSktjM0J5WldGa2MyaGxaWFFpTENKa1lYUmxJam94TnpVMk56a3lPVEExTENKa2IyMWhhVzRpT2xzaWFuTndjbVZoWkhOb1pXVjBMbU52YlNJc0ltTnZaR1Z6WVc1a1ltOTRMbWx2SWl3aWFuTm9aV3hzTG01bGRDSXNJbU56WWk1aGNIQWlMQ0p6ZEdGamEySnNhWFI2TG1sdklpd2lkMlZpWTI5dWRHRnBibVZ5TG1sdklpd2lkMlZpSWl3aWJHOWpZV3hvYjNOMElsMHNJbkJzWVc0aU9pSXpOQ0lzSW5OamIzQmxJanBiSW5ZM0lpd2lkamdpTENKMk9TSXNJbll4TUNJc0luWXhNU0lzSW1Ob1lYSjBjeUlzSW1admNtMXpJaXdpWm05eWJYVnNZU0lzSW5CaGNuTmxjaUlzSW5KbGJtUmxjaUlzSW1OdmJXMWxiblJ6SWl3aWFXMXdiM0owWlhJaUxDSmlZWElpTENKMllXeHBaR0YwYVc5dWN5SXNJbk5sWVhKamFDSXNJbkJ5YVc1MElpd2ljMmhsWlhSeklpd2lZMnhwWlc1MElpd2ljMlZ5ZG1WeUlpd2ljMmhoY0dWeklpd2labTl5YldGMElsMHNJbVJsYlc4aU9uUnlkV1Y5');
// Set the extensions
jspreadsheet.setExtensions({ formula });
@Component({
standalone: true,
selector: "app-root",
template: `<div #spreadsheet></div>`
})
export class AppComponent {
@ViewChild("spreadsheet") spreadsheet: ElementRef;
// Worksheets
worksheets: jspreadsheet.worksheetInstance[];
// Create a new data grid
ngAfterViewInit() {
// Create spreadsheet
this.worksheets = jspreadsheet(this.spreadsheet.nativeElement, {
worksheets: [{
data: [
[
"Date Text",
"Serial Number",
"Formatted Date"
],
[
"2024-01-15",
"=DATEVALUE(A2)",
"=TEXT(B2,\"mm/dd/yyyy\")"
],
[
"2024-06-30",
"=DATEVALUE(A3)",
"=TEXT(B3,\"mm/dd/yyyy\")"
],
[
"2024-12-25",
"=DATEVALUE(A4)",
"=TEXT(B4,\"mm/dd/yyyy\")"
]
]
}]
});
}
}