Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # startsWith `startsWith` evalúa si la expresión comienza por la subcadena que especifique. Si la expresión comienza por la subcadena, `startsWith` devuelve true y, en caso contrario, devuelve false. ## Sintaxis ``` startsWith(expression, substring, string-comparison-mode) ``` ## Argumentos *expresión* La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena. *subcadena* El conjunto de caracteres que se comparan con la *expresión*. La subcadena puede aparecer una o más veces en la *expresión*. *string-comparison-mode* (Opcional) Especifica el modo de comparación de cadenas que se va a utilizar: + `CASE_SENSITIVE`: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas. + `CASE_INSENSITIVE`: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas. Este valor se establece de forma predeterminada en `CASE_SENSITIVE` cuando está en blanco. ## Tipo de devolución Booleano ## Ejemplos ### Ejemplo de distinción entre mayúsculas y minúsculas predeterminado En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` startsWith **New**. ``` startsWith(state_nm, "New") ``` Los siguientes son los valores de los campos. ``` New York new york ``` Para estos valores de campo, se devuelven los siguientes valores. ``` true false ``` ### Ejemplo que no distingue entre mayúsculas y minúsculas En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` startsWith **new**. ``` startsWith(state_nm, "new", CASE_INSENSITIVE) ``` Los siguientes son los valores de los campos. ``` New York new york ``` Para estos valores de campo, se devuelven los siguientes valores. ``` true true ``` ### Ejemplo con instrucciones condicionales La función `startsWith` se puede utilizar como instrucción condicional en las siguientes funciones If: [avgIf](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) y [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). El siguiente ejemplo solo suma `Sales` si state\$1nm comienza por **New**. ``` sumIf(Sales,startsWith(state_nm, "New")) ``` ### NO contiene un ejemplo El operador condicional `NOT` se puede usar para evaluar si la expresión no comienza por la subcadena especificada. ``` NOT(startsWith(state_nm, "New")) ``` ### Ejemplo de uso de valores numéricos Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función `toString`. ``` startsWith(state_nm, toString(5) ) ```