Class DataExecutionStatus
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
حالةتنفيذ البيانات
حالة تنفيذ البيانات
مستندات تفصيلية
getErrorMessage()
تحصل على رسالة الخطأ المتعلّقة بتنفيذ البيانات. قد تكون الرسالة فارغة.
الإرجاع
String
: رسالة الخطأ
getLastExecutionTime()
تحصل على وقت اكتمال تنفيذ البيانات الأخير بصرف النظر عن حالة التنفيذ.
الإرجاع
Date
: وقت التنفيذ الأخير، أو null
إذا لم يسبق تنفيذ البيانات.
getLastRefreshedTime()
تحصل على وقت آخر عملية تحديث ناجحة للبيانات.
الإرجاع
Date
: آخر مرة تم فيها تعديل البيانات بنجاح، أو null
إذا لم تتم عملية تعديل بيانات ناجحة أبدًا
isTruncated()
تعرِض القيمة true
إذا تم اقتطاع البيانات من آخر عملية تنفيذ ناجحة، أو false
في حال أخرى.
الإرجاع
Boolean
— True
إذا تم اقتطاع البيانات من التنفيذ، أو false
في الحالات الأخرى
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eDataExecutionStatus\u003c/code\u003e provides methods to access the state and details of a data execution, including error information and timing.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the execution state, error code, and error message using dedicated methods.\u003c/p\u003e\n"],["\u003cp\u003eTimestamps for the last execution and successful refresh are accessible for tracking data updates.\u003c/p\u003e\n"],["\u003cp\u003eA method is available to determine if the data from the last successful execution was truncated.\u003c/p\u003e\n"]]],["The `DataExecutionStatus` provides information about data execution. It allows retrieving the error code and message, alongside the execution state. It also details the last execution time and the last successful refresh time. Additionally, it indicates whether the data from the last successful execution was truncated. The class provide methods for accessing those information like `getErrorCode()`, `getErrorMessage()`, `getExecutionState()`, `getLastExecutionTime()`, `getLastRefreshedTime()` and `isTruncated()`.\n"],null,["# Class DataExecutionStatus\n\nDataExecutionStatus\n\nThe data execution status. \n\n### Methods\n\n| Method | Return type | Brief description |\n|---------------------------------------------------|----------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|\n| [getErrorCode()](#getErrorCode()) | [DataExecutionErrorCode](/apps-script/reference/spreadsheet/data-execution-error-code) | Gets the error code of the data execution. |\n| [getErrorMessage()](#getErrorMessage()) | `String` | Gets the error message of the data execution. |\n| [getExecutionState()](#getExecutionState()) | [DataExecutionState](/apps-script/reference/spreadsheet/data-execution-state) | Gets the state of the data execution. |\n| [getLastExecutionTime()](#getLastExecutionTime()) | `Date` | Gets the time the last data execution completed regardless of the execution state. |\n| [getLastRefreshedTime()](#getLastRefreshedTime()) | `Date` | Gets the time the data last successfully refreshed. |\n| [isTruncated()](#isTruncated()) | `Boolean` | Returns `true` if the data from last successful execution is truncated, or `false` otherwise. |\n\nDetailed documentation\n----------------------\n\n### `get``Error``Code()`\n\nGets the error code of the data execution.\n\n#### Return\n\n\n[DataExecutionErrorCode](/apps-script/reference/spreadsheet/data-execution-error-code) --- The error code.\n\n*** ** * ** ***\n\n### `get``Error``Message()`\n\nGets the error message of the data execution. The message may be empty.\n\n#### Return\n\n\n`String` --- The error message.\n\n*** ** * ** ***\n\n### `get``Execution``State()`\n\nGets the state of the data execution.\n\n#### Return\n\n\n[DataExecutionState](/apps-script/reference/spreadsheet/data-execution-state) --- The execution state.\n\n*** ** * ** ***\n\n### `get``Last``Execution``Time()`\n\nGets the time the last data execution completed regardless of the execution state.\n\n#### Return\n\n\n`Date` --- The last execution time, or `null` if there has never been a data execution.\n\n*** ** * ** ***\n\n### `get``Last``Refreshed``Time()`\n\nGets the time the data last successfully refreshed.\n\n#### Return\n\n\n`Date` --- The last successfully refreshed time, or `null` if there is never a successful\ndata execution.\n\n*** ** * ** ***\n\n### `is``Truncated()`\n\nReturns `true` if the data from last successful execution is truncated, or `false`\notherwise.\n\n#### Return\n\n\n`Boolean` --- `True` if the data from execution is truncated, or `false` otherwise."]]